入門基礎
Chart.js 是一個基於 HTML5 的開源圖表庫,能簡潔便利地繪製美觀的圖表。
主要特性包括:
1、支援 6 種不同的圖表類型:曲線圖、柱狀圖、餅狀圖、雷達圖、極坐標區域圖、環圖。
2、基於 HTML5 開發,支援所有瀏覽器(含 IE7/8)。
3、不依賴任何其他庫,僅 4.5k 大小,且可自訂。
Chart.js 是一個基於 HTML5 canvas 的響應式、靈活、輕量化的圖表庫,內建六種圖表類型,每種類型都帶有一系列自訂選項;若這些還不夠,你甚至可以打造自己的圖表類型。
Chart.js 六種圖表類型的程式碼一共只有 11kb,並做了 gzip 壓縮處理;此外它是模組化的,你可以只引入自己需要的圖表類型,進一步節省空間。以下是包含該庫的 cdnjs 連結。
JavaScript
<script src="https://cdnjs.cloudflare.com/ajax/libs/Chart.js/1.0.2/Chart.min.js"></script>
可用的設定項
從提示資訊到動畫效果(譯註:tool tip 指滑鼠移到某元素上彈出的提示資訊),Chart.js 允許你改變圖表的幾乎所有特徵。本節我將修改一些設定,展示 Chart.js 是如何被建構出來的。我們從下面的 HTML 程式碼開始:
XHTML
<canvas id="canvas"></canvas>
為了首次展示,我會建立一個折線圖。為了讓圖表有意義,這裡有幾個需要設定的基本選項:折線圖需要一個標籤陣列與資料集,標籤會顯示在 X 軸。我已為折線圖模擬了一些資料,分開放進陣列裡,每筆資料都有自己的填滿色、折線與點集。
在這個例子中,我把 fillColor 設為透明。若不設定 fillColor 的值,將預設為黑色或灰色,其他值也同理。色彩使用 RGBA、RGB、hex 或 HSL 格式定義,與 CSS 相同。
JavaScript
var lineData = { labels: ['Data 1', 'Data 2', 'Data 3', 'Data 4', 'Data 5', 'Data 6', 'Data 7'], datasets: [{ fillColor: 'rgba(0,0,0,0)', strokeColor: 'rgba(220,180,0,1)', pointColor: 'rgba(220,180,0,1)', data: [20, 30, 80, 20, 40, 10, 60] }, { fillColor: 'rgba(0,0,0,0)', strokeColor: 'rgba(151,187,205,1)', pointColor: 'rgba(151,187,205,1)', data: [60, 10, 40, 30, 80, 30, 20] }] }設定全域選項
程式碼中我已設定了一些全域值。animationSteps 決定動畫的持續時間,你可以按需修改更多選項,例如 scaleLineColor 與 scaleIntegersOnly。我建議翻閱 Chart.js 文件,查看庫中提供的其他選項。
JavaScript
Chart.defaults.global = { animationSteps : 50, tooltipYPadding : 16, tooltipCornerRadius : 0, tooltipTitleFontStyle : 'normal', tooltipFillColor : 'rgba(0,160,0,0.8)', animationEasing : 'easeOutBounce', scaleLineColor : 'black', scaleFontSize : 16 }設定專屬的圖表選項
除了全域選項,還有一些針對特定圖表型態的設定選項。在這個折線圖中,我會設定這類選項,希望對你有所啟發:
JavaScript
Chart.defaults.global = { animationSteps : 50, tooltipYPadding : 16, tooltipCornerRadius : 0, tooltipTitleFontStyle : 'normal', tooltipFillColor : 'rgba(0,160,0,0.8)', animationEasing : 'easeOutBounce', scaleLineColor : 'black', scaleFontSize : 16 }Chart.js 產生的圖表預設為非響應式,把 responsive 設為 true 即可將其轉為響應式圖表。若你需要讓每個圖表都成為響應式,我建議設定全域值,像这样:
JavaScript
Chart.defaults.global.responsive = true;
下面你會看到這個折線圖的示例:
See the Pen Chart.js Responsive Line Chart Demo by SitePoint (@SitePoint) on CodePen.
增加與移除動態資料
有時你需要展示時刻變化的資料,股票市場便是典型的應用場景。本節我將建立一個柱形圖,並在動態刪除資料的同時增加資料。我會用一些隨機資料,透過柱形圖來展示。本例中的大部分程式碼與上一個例子相似,一旦我們有了自己的 HTML(與上一個例子一樣),便可加上自己的 JavaScript。
首先我們需要編寫程式碼,把動態資料填入圖表。我用 function 表達式產生隨機值,再賦給一個變數 dData,這些值會在需要變化時為我們提供隨機資料。像之前的例子一樣,我建立了一個標籤陣列與資料集,並設定了任意的 fillColor。
JavaScript
var dData = function() { return Math.round(Math.random() * 90) + 10; }; var barData = { labels: ['dD 1', 'dD 2', 'dD 3', 'dD 4', 'dD 5', 'dD 6', 'dD 7', 'dD 8'], datasets: [{ fillColor: 'rgba(0,60,100,1)', strokeColor: 'black', data: [dData(), dData(), dData(), dData(), dData(), dData(), dData(), dData()] }] }現在是時候編寫程式碼,為圖表刪除與添加柱形了。開始時我們把 index 的值設為 11,我使用了兩個方法:removeData() 與 addData(valuesArray, label)。呼叫實例的 removeData() 會刪除圖表所有資料集的第一個值;在這個例子中,資料集的第一個值被移除。呼叫 addData() 時順著標籤傳遞一個陣列值,會在圖表最後增加一個新的資料節點。下面的程式碼片段每 3 秒更新一次圖表。
JavaScript
var index = 11; var ctx = document.getElementById('canvas').getContext('2d'); var barDemo = new Chart(ctx).Bar(barData, { responsive: true }); setInterval(function() { barDemo.removeData(); barDemo.addData([dData()], 'dD ' + index); index++; }, 3000);另一個更新圖表數值的方法是直接設定數值。在下面的例子中,第一行把第一個資料集的第二個柱形的數值設為 60;此時若更新,柱形會透過動畫把當前值變為 60。
JavaScript
barDemo.datasets[0].bars[2].value = 60; barDemo.update();
以下是柱形圖的示例(由 SitePoint 在 CodePen 上建立):
See the Pen Chart.js Responsive Bar Chart Demo by SitePoint (@SitePoint) on CodePen.
結論
本教學涵蓋了 Chart.js 的一些重要功能。第一個例子展示了全域設定的用法,同時 Chart.js 也為每個圖表類型提供了專屬的自訂設定。若目前可用的圖表無法滿足需求,你還可以自己創造圖表類型。我建議你翻閱文件,加深對這個庫能做什麼、不能做什麼的認識。