gRaphael 是一個致力於幫助開發人員在網頁中繪製各種精美圖表的 JavaScript 函式庫,它建立在強大的 Raphael 向量圖形庫之上。你只需要撰寫幾行簡單的程式碼,就能建立出條形圖、餅圖、點圖與曲線圖。
gRaphael 使用 SVG(W3C 推薦標準)與 VML 作為建立圖形的基礎,因此是跨瀏覽器的向量圖形庫。它支援的瀏覽器包括 Firefox 3.0+、Safari 3.0+、Chrome 5.0+、Opera 9.5+ 以及 Internet Explorer 6.0+。

在頁面中引入 raphael.js 與 g.raphael.js,再依需要引入對應的圖表模組:
g.line.js:曲線圖g.bar.js:條形圖g.dot.js:點圖g.pie.js:餅圖然後依各模組提供的方法呼叫即可。以下是兩個簡單範例。
只需要兩行程式碼:
// 在座標(10,50)建立 600 × 450 的畫布 var r = Raphael(10, 50, 600, 450); // 建立中心座標為(320, 200)的餅圖,半徑為 150,數據為 [55, 20, 13, 32, 5, 1, 2, 10] 的餅圖 r.piechart(320, 240, 150, [55, 20, 13, 32, 5, 1, 2, 10]);

結合 hover 與 click 事件以及動畫方法,就能建立具互動性的餅圖:
// 在座標(10,50)建立 640 × 480 的畫布
var r = Raphael(10, 50, 640, 480);
// 建立中心座標為(320, 240)的餅圖,半徑為 100,數據為 [55, 20, 13, 32, 5, 1, 2, 10]
pie = r.piechart(320, 240, 100, [55, 20, 13, 32, 5, 1, 2, 10], {
legend: ["%%.%% - Enterprise Users", "IE Users"],
legendpos: "west",
href: ["https://raphaeljs.com", "https://g.raphaeljs.com"]
});
// 在座標(320, 100)繪製文字
r.text(320, 100, "Interactive Pie Chart").attr({
font: "20px sans-serif"
});
// 給餅圖添加 hover 事件
pie.hover(function() {
this.sector.stop();
this.sector.scale(1.1, 1.1, this.cx, this.cy);
if(this.label) {
this.label[0].stop();
this.label[0].attr({
r: 7.5
});
this.label[1].attr({
"font-weight": 800
});
}
}, function() {
this.sector.animate({
transform: 's1 1 ' + this.cx + ' ' + this.cy
}, 500, "bounce");
// 添加動畫效果
if(this.label) {
this.label[0].animate({
r: 5
}, 500, "bounce");
this.label[1].attr({
"font-weight": 400
});
}
});

這段程式碼有幾個細節值得欣賞。pie.hover 的 callback 中,this 指向的是被 hover 的那個扇區物件,而 this.cx/this.cy 是圓心座標——放大動畫之所以指定中心點,是為了讓扇區「從圓心往外長」,而不是從畫布原點偏移。stop() 則用來中止前一次未完成的動畫,避免快速滑過時動畫堆疊導致扇區愈來愈大。legend 中的 %%.%% 是百分比的佔位符,會自動被換成實際比例。
gRaphael 官方網站:https://g.raphaeljs.com/
gRaphael 英文參考文件:https://g.raphaeljs.com/reference.html
Raphael 官方網站:https://raphaeljs.com
Raphael 英文參考文件:https://raphaeljs.com/reference.html
Raphael 中文說明文件:https://julying.com/lab/raphael-js/docs/
Raphael 新手入門教學:An Introduction to the Raphael JS Library
gRaphael 的價值在於「極簡」:兩行畫一張餅圖,對早期需要支援 IE6 的專案來說幾乎沒有更好的選擇。Raphael 之所以能跨瀏覽器,正是因為它會自動偵測環境——支援 SVG 的用 SVG,否則退回 VML,這也是它能支援 IE6 的原因。
但若你今天要開新專案,建議改用 Chart.js 或 ECharts。理由有三:
第一,gRaphael 已停止維護多年,社群與文件都不再更新,遇到問題只能自己讀原始碼。
第二,功能相對有限。它沒有 tooltip、縮放、資料篩選、圖表聯動這些現代儀表板必備的能力,也沒有響應式設計的支援。
第三,它依賴 VML,而 VML 早已從所有主流瀏覽器中移除,這部分程式碼如今只是無用的重量。
如果只是想畫幾個簡單圖表且要極致輕量,Chart.js 在 gzip 後體積很小、API 同樣直覺;若需要複雜的統計圖表與互動,ECharts 是更完整的選擇。理解 gRaphael 的「容器 + 座標 + 資料陣列」這個基本模型仍然有用,因為所有圖表庫的核心概念都類似,換一個工具時遷移成本並不高。