資料數值儀表顯示功能
資料數值儀表顯示功能
儀表顯示功能是一種資料視覺化效果,利用儀表板上不同顏色及佔有區域,快速掌握該筆資料數值所代表的意涵,對於有分層級的數值資料,是一項良好的視覺化呈現方式。欲使用儀表方式呈現的資料,支援CSV檔案,並且需要將檔案掛載到網路環境,不支援本機檔案讀取。
需要自行建置顯示儀表的框架,在範例程式前段的Style即是框架相關設定。利用TGOS.TGGauge()讀取CSV檔案資料,指定dataField屬性為資料數值欄位,dataLabelField屬性為資料標記欄位,設定低、中、高分級顏色,即可顯示儀表板,在預設狀況下,資料將被分成三個層級,API在讀取CSV檔案後,將利用最大資料數值並三等分,作為三個層級的分界。
var param = {
layer: monthLayer, //資料來源的CSV Layer
maxDataValue: 10, //最大資料數值
dataField: "mag", //比對資料欄位
unitLabel: "規模", //單位
title: "地震規模資料", //資料標題
dataLabelField: "place", //資料Label欄位
lowColor: "#0000FF", //低分級的顏色
midColor: "#00FF00", //中分級的顏色
highColor: "#FF0000", //高分級的顏色
caption: "請將滑鼠移到地震標記上方" //次標題或是tip相關
};
//建議TGGauge 儀表版本體
gaugeNode = document.getElementById("gaugeNode");
gaugeControl = new TGOS.TGGauge(gaugeNode, param);
如果想要變更資料層級數量,或是層級分界並非三等均分,則需使用addBreak()方法,自行加入層級的定義,包含層級的起迄範圍、顯示顏色等。在有設定的狀況下,預設值將會無效。
gaugeControl.addBreak(0, 3, "#00FF00");
gaugeControl.addBreak(3.1, 7, "#EEEE00");
gaugeControl.addBreak(7.1, 10, "#FF0000");