使用 jqPlot 前,需載入 jQuery、jqPlot 核心 CSS 與 JS,以及需要的插件。例如柱狀圖、標籤、座標軸文字、游標與高亮等功能,通常會對應不同插件檔。
頁面中需準備具有寬高的 div 作為繪圖區域。若容器沒有明確尺寸,圖表可能無法正常顯示。
常見做法是先準備 ticks 陣列作為 X 軸標籤,再將一或多組數值陣列傳入 jqPlot。若使用 CategoryAxisRenderer,就能讓 X 軸以分類文字呈現;若要顯示日期,也可改用日期軸渲染器。
var plot = $.jqplot('chart', [data], {
title: '現金收益',
axes: {
xaxis: { renderer: $.jqplot.CategoryAxisRenderer }
}
});
透過 pointLabels 可在數據點旁顯示數值;透過 highlighter 可在滑鼠移入時放大節點並顯示提示;cursor 則能顯示十字游標或提示框。若資料來自後端,也可使用 dataRenderer 搭配同步或異步請求。
整體而言,jqPlot 的實作重點在於先確認容器尺寸,再依需求組合 renderer、axes、seriesDefaults 與互動插件。