前言
在數據可視化日益成為業務決策核心驅動力的今天,高效、靈活的圖表配置系統已成為開發人員不可或缺的工具。OneCode圖表組件憑借其豐富的圖表類型與精細化的配置能力,為開發者提供了構建專業數據可視化界面的完整解決方案。然而,隨著圖表類型的不斷擴展與配置項的日益豐富,如何快速定位并正確使用特定配置屬性已成為提升開發效率的關鍵挑戰。
本配置字典博文旨在為開發者提供一份全面、系統的OneCode圖表配置參考手冊。基于對組件配置文件的深度解析,我們梳理了包括Pyramid、Radar、RealTimeLine、Funnel、HLED、Thermometer等15+圖表類型的全部配置屬性,涵蓋圖表標題、功能屬性、外觀樣式、數據格式、交互效果等六大核心維度。每個配置項均包含詳細的屬性說明、取值范圍與默認值定義,形成結構化的配置速查體系。
無論是實時數據監控場景中需要調整的RealTimeLine
刷新頻率,還是儀表盤展示中關鍵的AngularGauge
指針樣式,抑或是布局優化時必不可少的邊距(chartLeftMargin
)與填充(captionPadding
)設置,讀者都能在此找到權威的配置指南。我們特別對跨圖表通用配置項(如字體屬性、數值格式化、工具提示)進行了歸納整理,幫助開發者建立全局配置思維。
本文檔不僅是新手入門的學習手冊,更是資深開發者的案頭速查工具。通過左側導航的圖表類型索引與配置項功能分類,您可以快速定位所需內容。隨文附上的配置示例與實際效果對照,將幫助您更直觀地理解各項配置的作用機制。
我們期待這份配置字典能夠成為您駕馭OneCode圖表組件的得力助手,讓每一個數據可視化需求都能找到最精準的配置方案,最終實現業務數據的高效表達與價值傳遞。
1. Pyramid (金字塔圖)
1.1 圖表基本配置配置項 說明 類型 可選值 默認值 caption
圖表標題文本 String 任意文本 “” captionFontSize
標題字體大小 Number 8-72 14 captionFontColor
標題字體顏色 String 顏色代碼 “#333333” captionAlignment
標題對齊方式 String left/center/right “center” subCaption
圖表副標題文本 String 任意文本 “” subCaptionFontSize
副標題字體大小 Number 8-72 12
1.2 功能屬性配置項 說明 類型 可選值 默認值 animation
是否啟用動畫效果 Boolean true/false true palette
圖表調色板 Number/Array 0-19或顏色數組 0 showPrintMenu
是否顯示打印菜單 Boolean true/false true showDownloadMenu
是否顯示下載菜單 Boolean true/false true showHoverEffect
是否啟用懸停效果 Boolean true/false true enableSlicing
是否允許切片交互 Boolean true/false false
1.3 金字塔特有屬性配置項 說明 類型 可選值 默認值 pyramidMode
金字塔顯示模式 String “2D”/“sliced” “2D” yAxisMinValue
Y軸最小值 Number 任意數值 0 yAxisMaxValue
Y軸最大值 Number 任意數值 自動計算 pyramidBaseWidth
金字塔底部寬度百分比 Number 10-100 80 pyramidTopWidth
金字塔頂部寬度百分比 Number 0-50 10 isInverted
是否反轉金字塔方向 Boolean true/false false
2. Radar (雷達圖)
2.1 圖表配置配置項 說明 類型 可選值 默認值 caption
圖表標題 String 任意文本 “” xAxisName
X軸名稱 String 任意文本 “” yAxisName
Y軸名稱 String 任意文本 “” showBorder
是否顯示邊框 Boolean true/false true borderColor
邊框顏色 String 顏色代碼 “#666666” bgColor
圖表背景色 String 顏色代碼 “#FFFFFF” canvasBgColor
畫布背景色 String 顏色代碼 “#FFFFFF”
2.2 數據系列配置配置項 說明 類型 可選值 默認值 showLabels
是否顯示數據標簽 Boolean true/false true showValues
是否顯示數據值 Boolean true/false false labelFontSize
標簽字體大小 Number 8-72 12 valueFontSize
數值字體大小 Number 8-72 12 dataPointRadius
數據點半徑 Number 1-20 4 connectNullData
是否連接空數據點 Boolean true/false false
2.3 雷達圖特有屬性配置項 說明 類型 可選值 默認值 radarFillColor
雷達圖填充顏色 String 顏色代碼 “#F8F8F8” radarFillAlpha
雷達圖填充透明度 Number 0-100 30 borderThickness
雷達圖邊框厚度 Number 1-10 2 numDivLines
分割線數量 Number 1-20 5 divLineColor
分割線顏色 String 顏色代碼 “#CCCCCC” showAxes
是否顯示軸線 Boolean true/false true
3. RealTimeLine (實時折線圖)
3.1 標題與軸配置配置項 說明 類型 可選值 默認值 caption
圖表標題 String 任意文本 “” xAxisName
X軸名稱 String 任意文本 “Time” yAxisName
Y軸名稱 String 任意文本 “Value” xAxisNameFontSize
X軸名稱字體大小 Number 8-72 12 yAxisNameFontSize
Y軸名稱字體大小 Number 8-72 12 xAxisValuesFontSize
X軸值字體大小 Number 8-72 11 yAxisValuesFontSize
Y軸值字體大小 Number 8-72 11
3.2 實時屬性配置配置項 說明 類型 可選值 默認值 updateInterval
數據更新間隔(毫秒) Number 100-5000 1000 dataStreamURL
實時數據URL String 有效URL “” refreshOnLoad
加載時是否刷新 Boolean true/false true showRTMenuItem
是否顯示實時菜單 Boolean true/false true rtAutoUpdate
是否自動更新 Boolean true/false true rtUpdateOnScroll
滾動時是否更新 Boolean true/false false bufferSize
數據緩沖區大小 Number 5-100 10
3.3 折線圖特有屬性配置項 說明 類型 可選值 默認值 lineThickness
線條厚度 Number 1-10 2 anchorRadius
錨點半徑 Number 1-20 4 anchorBorderThickness
錨點邊框厚度 Number 0-5 1 anchorBgColor
錨點背景色 String 顏色代碼 “#FFFFFF” anchorBorderColor
錨點邊框顏色 String 顏色代碼 系列顏色 showAnchors
是否顯示錨點 Boolean true/false true anchorSides
錨點邊數 Number 3-100 4
4. RealTimeLineDY (雙Y軸實時折線圖)
4.1 雙Y軸配置配置項 說明 類型 可選值 默認值 showPrimaryYAxis
是否顯示主Y軸 Boolean true/false true showSecondaryYAxis
是否顯示次Y軸 Boolean true/false true primaryYAxisName
主Y軸名稱 String 任意文本 “Value 1” secondaryYAxisName
次Y軸名稱 String 任意文本 “Value 2” primaryYAxisMinValue
主Y軸最小值 Number 任意數值 0 primaryYAxisMaxValue
主Y軸最大值 Number 任意數值 自動計算 secondaryYAxisMinValue
次Y軸最小值 Number 任意數值 0 secondaryYAxisMaxValue
次Y軸最大值 Number 任意數值 自動計算 syncAxisLimits
是否同步軸限制 Boolean true/false false
4.2 其他特有屬性配置項 說明 類型 可選值 默認值 numDivLinesPrimaryYAxis
主Y軸分割線數量 Number 1-20 5 numDivLinesSecondaryYAxis
次Y軸分割線數量 Number 1-20 5 primaryYAxisColor
主Y軸顏色 String 顏色代碼 “#1A80E5” secondaryYAxisColor
次Y軸顏色 String 顏色代碼 “#F53F3F” showAxisOnLeft
是否在左側顯示軸 Boolean true/false true
5. RealTimeStackedArea (實時堆疊面積圖)
5.1 面積圖配置配置項 說明 類型 可選值 默認值 fillAlpha
填充透明度 Number 0-100 70 showAreaBorder
是否顯示面積邊框 Boolean true/false true areaBorderColor
面積邊框顏色 String 顏色代碼 系列顏色 areaBorderThickness
面積邊框厚度 Number 1-5 1 stack100Percent
是否100%堆疊 Boolean true/false false showShadow
是否顯示陰影 Boolean true/false false shadowColor
陰影顏色 String 顏色代碼 “#000000” shadowAlpha
陰影透明度 Number 0-100 30
6. RealTimeColumn (實時柱狀圖)
6.1 柱狀圖配置配置項 說明 類型 可選值 默認值 columnWidth
柱寬百分比 Number 10-90 60 showColumnShadow
是否顯示柱陰影 Boolean true/false false shadowAlpha
陰影透明度 Number 0-100 40 use3DLighting
是否使用3D光照 Boolean true/false false columnBorderThickness
柱邊框厚度 Number 0-5 1 columnBorderColor
柱邊框顏色 String 顏色代碼 “#FFFFFF” showZeroPlane
是否顯示零平面 Boolean true/false true zeroPlaneColor
零平面顏色 String 顏色代碼 “#CCCCCC”
7. RealTimeStackedColumn (實時堆疊柱狀圖)
7.1 堆疊柱狀圖配置配置項 說明 類型 可選值 默認值 stack100Percent
是否100%堆疊 Boolean true/false false showCumulativeValues
是否顯示累積值 Boolean true/false false cumulativeLabelFontSize
累積標簽字體大小 Number 8-72 12 cumulativeLabelFontColor
累積標簽字體顏色 String 顏色代碼 “#333333” plotSpacePercent
繪圖空間百分比 Number 0-100 80
8. HLED/VLED (水平/垂直LED圖表)
8.1 LED通用配置配置項 說明 類型 可選值 默認值 value
當前值 Number 任意數值 0 minValue
最小值 Number 任意數值 0 maxValue
最大值 Number 任意數值 100 ledSize
LED大小 Number 5-50 15 ledSpacing
LED間距 Number 0-20 2 showValue
是否顯示值 Boolean true/false true valueFontSize
值字體大小 Number 8-72 14
8.2 顏色范圍配置配置項 說明 類型 可選值 默認值 colorRange
顏色范圍配置 Array 顏色范圍對象數組 見下方示例 useColorName
是否使用顏色名稱 Boolean true/false true
colorRange示例配置:
colorRange: [ { minValue: 0 , maxValue: 30 , color: "#FF0000" } , { minValue: 31 , maxValue: 70 , color: "#FFFF00" } , { minValue: 71 , maxValue: 100 , color: "#00FF00" }
]
9. Cylinder (圓柱圖)
9.1 圓柱圖配置配置項 說明 類型 可選值 默認值 cylinderRadius
圓柱半徑百分比 Number 10-90 40 cylinderHeight
圓柱高度百分比 Number 10-90 80 showCylinderBorder
是否顯示圓柱邊框 Boolean true/false true cylinderBorderColor
圓柱邊框顏色 String 顏色代碼 “#FFFFFF” cylinderBorderThickness
圓柱邊框厚度 Number 1-5 1 fillColor
填充顏色 String 顏色代碼 “#1A80E5” fillAlpha
填充透明度 Number 0-100 80 showValue
是否顯示值 Boolean true/false true
10. Thermometer (溫度計圖)
10.1 溫度計配置配置項 說明 類型 可選值 默認值 value
當前溫度值 Number 任意數值 0 minValue
最低溫度 Number 任意數值 0 maxValue
最高溫度 Number 任意數值 100 thermometerHeight
溫度計高度 Number 50-500 200 thermometerWidth
溫度計寬度 Number 10-100 30 bulbRadius
底部燈泡半徑 Number 5-50 15 showValue
是否顯示值 Boolean true/false true valueFontSize
值字體大小 Number 8-72 14 colorRange
顏色范圍配置 Array 顏色范圍對象數組 見下方示例
colorRange示例配置:
colorRange: [ { minValue: 0 , maxValue: 30 , color: "#0000FF" } , { minValue: 31 , maxValue: 60 , color: "#00FF00" } , { minValue: 61 , maxValue: 100 , color: "#FF0000" }
]
11. HLinearGauge (水平線性儀表)
11.1 儀表配置配置項 說明 類型 可選值 默認值 value
當前值 Number 任意數值 0 minValue
最小值 Number 任意數值 0 maxValue
最大值 Number 任意數值 100 gaugeLength
儀表長度 Number 100-1000 300 gaugeHeight
儀表高度 Number 20-200 60 showValue
是否顯示值 Boolean true/false true valueFontSize
值字體大小 Number 8-72 14 pointerLength
指針長度百分比 Number 50-100 80 pointerThickness
指針厚度 Number 1-10 3 pointerColor
指針顏色 String 顏色代碼 “#FF0000”
11.2 刻度配置配置項 說明 類型 可選值 默認值 majorTMNumber
主刻度數量 Number 2-20 5 minorTMNumber
次刻度數量 Number 0-10 4 majorTMHeight
主刻度高度 Number 5-30 15 minorTMHeight
次刻度高度 Number 5-20 10 majorTMColor
主刻度顏色 String 顏色代碼 “#333333” minorTMColor
次刻度顏色 String 顏色代碼 “#666666”
12. AngularGauge (角度儀表)
12.1 角度儀表配置配置項 說明 類型 可選值 默認值 value
當前值 Number 任意數值 0 minValue
最小值 Number 任意數值 0 maxValue
最大值 Number 任意數值 100 gaugeStartAngle
儀表起始角度 Number 0-360 135 gaugeEndAngle
儀表結束角度 Number 0-360 45 gaugeOuterRadius
儀表外半徑 Number 50-500 100 gaugeInnerRadius
儀表內半徑 Number 0-450 0 showValue
是否顯示值 Boolean true/false true valueFontSize
值字體大小 Number 8-72 14
12.2 指針配置配置項 說明 類型 可選值 默認值 dialRadius
指針半徑百分比 Number 50-100 80 dialThickness
指針厚度 Number 1-20 5 dialColor
指針顏色 String 顏色代碼 “#FF0000” pivotRadius
軸點半徑 Number 5-20 8 pivotColor
軸點顏色 String 顏色代碼 “#333333” pivotBorderColor
軸點邊框顏色 String 顏色代碼 “#FFFFFF” pivotBorderThickness
軸點邊框厚度 Number 1-5 2
13. Annotations (標注)
13.1 標注通用配置配置項 說明 類型 可選值 默認值 showBelow
是否顯示在圖表下方 Boolean true/false false drawAnchors
是否繪制錨點 Boolean true/false false id
標注ID String 唯一標識符 “” type
標注類型 String “text”/“line”/“rectangle”/“circle”/“arc”/“image”/“polygon”/“path” “text”
13.2 文本標注配置配置項 說明 類型 可選值 默認值 text
標注文本 String 任意文本 “” fontSize
字體大小 Number 8-72 12 fontColor
字體顏色 String 顏色代碼 “#000000” fontBold
是否粗體 Boolean true/false false fontItalic
是否斜體 Boolean true/false false x
X坐標 Number 任意數值 0 y
Y坐標 Number 任意數值 0 align
對齊方式 String left/center/right “left” rotation
旋轉角度 Number 0-360 0
13.3 線條標注配置配置項 說明 類型 可選值 默認值 x1
起點X坐標 Number 任意數值 0 y1
起點Y坐標 Number 任意數值 0 x2
終點X坐標 Number 任意數值 0 y2
終點Y坐標 Number 任意數值 0 thickness
線條厚度 Number 1-20 2 color
線條顏色 String 顏色代碼 “#000000” dashed
是否虛線 Boolean true/false false dashLen
虛線長度 Number 1-50 5 dashGap
虛線間距 Number 1-50 5 arrowAtStart
起點是否帶箭頭 Boolean true/false false arrowAtEnd
終點是否帶箭頭 Boolean true/false false arrowWidth
箭頭寬度 Number 1-20 5 arrowHeight
箭頭高度 Number 1-20 5
14. 通用配置項詳解
14.1 邊距和填充配置
prop: ["captionPadding", "xAxisNamePadding", "yAxisNamePadding", "yAxisValuesPadding", "labelPadding", "valuePadding", "plotSpacePercent", "chartLeftMargin", "chartRightMargin", "chartTopMargin", "chartBottomMargin", "legendPadding", "canvasLeftMargin", "canvasRightMargin", "canvasTopMargin", "canvasBottomMargin"]
配置項 說明 類型 默認值 captionPadding
標題內邊距 Number 10 xAxisNamePadding
X軸名稱內邊距 Number 5 yAxisNamePadding
Y軸名稱內邊距 Number 5 yAxisValuesPadding
Y軸值內邊距 Number 5 labelPadding
標簽內邊距 Number 5 valuePadding
值內邊距 Number 5 plotSpacePercent
繪圖空間百分比 Number 80 chartLeftMargin
圖表左邊距 Number 10 chartRightMargin
圖表右邊距 Number 10 chartTopMargin
圖表上邊距 Number 10 chartBottomMargin
圖表下邊距 Number 10 legendPadding
圖例內邊距 Number 5 canvasLeftMargin
畫布左邊距 Number 10 canvasRightMargin
畫布右邊距 Number 10 canvasTopMargin
畫布上邊距 Number 10 canvasBottomMargin
畫布下邊距 Number 10
14.2 圖例配置配置項 說明 類型 可選值 默認值 showLegend
是否顯示圖例 Boolean true/false true legendPosition
圖例位置 String top/bottom/left/right “bottom” legendFontSize
圖例字體大小 Number 8-72 12 legendFontColor
圖例字體顏色 String 顏色代碼 “#333333” legendBgColor
圖例背景色 String 顏色代碼 “#FFFFFF” legendBorderColor
圖例邊框顏色 String 顏色代碼 “#CCCCCC” legendBorderThickness
圖例邊框厚度 Number 0-5 1 legendShadow
是否顯示圖例陰影 Boolean true/false false legendAllowDrag
是否允許拖動圖例 Boolean true/false false
14.3 工具提示配置配置項 說明 類型 可選值 默認值 showTooltip
是否顯示工具提示 Boolean true/false true tooltipBgColor
工具提示背景色 String 顏色代碼 “#000000” tooltipBorderColor
工具提示邊框顏色 String 顏色代碼 “#666666” tooltipBorderThickness
工具提示邊框厚度 Number 0-5 1 tooltipFontColor
工具提示字體顏色 String 顏色代碼 “#FFFFFF” tooltipFontSize
工具提示字體大小 Number 8-72 12 tooltipAlpha
工具提示透明度 Number 0-100 90 tooltipPadding
工具提示內邊距 Number 0-20 5 tooltipSeparator
工具提示分隔符 String 任意文本 ": "
14.4 數值格式化配置配置項 說明 類型 可選值 默認值 numberPrefix
數值前綴 String 任意文本 “” numberSuffix
數值后綴 String 任意文本 “” decimalSeparator
小數點分隔符 String ./, “.” thousandSeparator
千分位分隔符 String ,/.\s “,” decimalPrecision
小數位數 Number 0-10 0 formatNumber
是否格式化數字 Boolean true/false true formatNumberScale
是否格式化數字刻度 Boolean true/false true scaleUnit
刻度單位 String K/M/B/T “” numberScaleValue
數字刻度值 Number 1000/1000000等 1000
15. 事件配置
15.1 通用事件配置項 說明 類型 可選值 默認值 clickURL
點擊圖表時的URL String 有效URL “” clickURLOpenInNewWindow
是否在新窗口打開URL Boolean true/false true onLoadComplete
加載完成事件 String JavaScript函數名 “” onClick
點擊事件 String JavaScript函數名 “” onMouseOver
鼠標懸停事件 String JavaScript函數名 “” onMouseOut
鼠標移出事件 String JavaScript函數名 “”
結語
以上是OneCode組件庫中所有圖表類型的詳細配置屬性說明。這些配置項覆蓋了從基礎外觀到高級交互的各個方面,通過靈活組合這些配置,可以創建出滿足各種需求的可視化圖表。實際使用時,建議結合具體場景選擇合適的配置項,并參考官方文檔獲取更多示例和最佳實踐。