搞懂這幾個名詞,之後看 API 文件會順暢很多:
1. 標題(Title)——主標題是必填的,副標題(subTitle)則可省略。
2. 座標軸(Axis)——X 軸(xAxis)與 Y 軸(yAxis)。
3. 數據列(Series)——每一條曲線、每一組柱狀條、圓餅圖的每一塊,都是一個數據列。
4. 數據提示框(Tooltip)——滑鼠移上去浮現的資訊框。
5. 圖例(Legend)——點擊標示可以顯示或隱藏對應的數據列。
6. 版權資訊(Credits)——預設顯示 Highcharts 官網連結,設 credits.enabled = false 即可隱藏(注意商用授權規範)。
7. 匯出功能按鈕(Exporting)——需要額外載入 exporting.js。
8. 標示線(PlotLines)——主動加上平均線、目標線這類輔助線。
9. 標示帶(PlotBands)——用來標出某段區間,例如「警戒範圍」。
方法一,jQuery 插件形式,用選擇器指定容器:
$(function () {
$(".chart").highcharts({});
});
方法二,直接用建構子,透過 renderTo 指定目標:
var charts = new Highcharts.Chart({
// Highcharts 設定
chart : {
renderTo : "container" // 注意這裡要寫元素的 ID,不要加 #
}
});
兩者效果相同。團隊專案裡方法二比較常見,因為不必依賴 jQuery。
Highcharts 會撐滿容器,所以實際上只要控制外層 div 的寬高即可:
style="width: 800px; height: 400px"
最常調整的四個項目:
• border——邊框,可設寬度、顏色與圓角(borderRadius)。
• backgroundColor——背景色,支援漸層。
• margin / spacing——margin 是圖表元素與邊界的距離;spacing 是容器內各區塊之間的間距。
• style——整體字型設定,例如 style: { fontFamily: 'Microsoft JhengHei' },中文環境建議一定要指定,否則數字與標題容易字型不一致。
把「九個組成區塊」當成地圖,再去查各區塊底下有哪些屬性,學習 Highcharts 就有清楚的路徑可循了。