# 元素

雖然圖表類型提供了設定來配置每個資料集的樣式,但有時您會希望以相同方式設定所有資料集的樣式。一個常見的例子是在長條圖中用相同的顏色描繪所有長條的邊框,但更改每個資料集的填充顏色。可以為四種不同類型的元素配置選項:弧形線條長條。設定後,這些選項會套用到該類型的所有物件,除非資料集附加的設定特別覆寫它們。

# 全域設定

可以為每個圖表或全域指定元素選項。元素的全域選項在 Chart.defaults.elements 中定義。例如,若要全域設定所有長條圖的邊框寬度,您可以執行以下操作:

Chart.defaults.elements.bar.borderWidth = 2;

# 點設定

點元素用於表示折線圖、雷達圖或泡泡圖中的點。

命名空間:options.elements.point,全域點選項:Chart.defaults.elements.point

名稱 類型 預設值 描述
radius number 3 點半徑。
pointStyle pointStyle 'circle' 點樣式。
rotation number 0 number
backgroundColor 顏色 Chart.defaults.backgroundColor 點填充顏色。
borderWidth number 1 number
borderColor 顏色 'Chart.defaults.borderColor 點邊框顏色。
hitRadius number 1 number
hoverRadius number 4 number
hoverBorderWidth number 1 number

# 點樣式

# 類型

pointStyle 引數接受以下類型的輸入:stringImageHTMLCanvasElement

# 資訊

當提供字串時,支援以下值

  • 'circle'
  • 'cross'
  • 'crossRot'
  • 'dash'
  • 'line'
  • 'rect'
  • 'rectRounded'
  • 'rectRot'
  • 'star'
  • 'triangle'
  • false

如果值是影像或畫布元素,則會使用 drawImage (在新視窗開啟)在畫布上繪製該影像或畫布元素。

# 線條設定

線條元素用於表示折線圖中的線條。

命名空間:options.elements.line,全域線條選項:Chart.defaults.elements.line

名稱 類型 預設值 描述
tension number 0 number
backgroundColor 顏色 Chart.defaults.backgroundColor Line fill color.
borderWidth number 3 number
borderColor 顏色 Chart.defaults.borderColor 線條邊框顏色。
borderCapStyle string 'butt' 線條端點樣式。請參閱 MDN (在新視窗開啟)
borderDash number[] [] 線條虛線。請參閱 MDN (在新視窗開啟)
borderDashOffset number 0.0 number
borderJoinStyle 'round'|'bevel'|'miter' 'miter' 線條連接樣式。請參閱 MDN (在新視窗開啟)
capBezierPoints boolean true true 將貝茲曲線控制點保持在圖表內,false 則不限制。
cubicInterpolationMode string 'default' 要套用的內插模式。查看更多...
fill boolean|string false 如何填充線條下方的區域。請參閱面積圖
stepped boolean false boolean

# 長條設定

長條元素用於表示長條圖中的長條。

命名空間:options.elements.bar,全域長條選項:Chart.defaults.elements.bar

名稱 類型 預設值 描述
backgroundColor 顏色 Chart.defaults.backgroundColor 長條填充顏色。
borderWidth number 0 長條邊框寬度。
borderColor 顏色 Chart.defaults.borderColor 長條邊框顏色。
borderSkipped string 'start' 跳過(排除)的邊框:'start''end''middle''bottom''left''top''right'false
borderRadius number|object 0 長條邊框半徑(以像素為單位)。
inflateAmount number|'auto' 'auto' 繪製時要膨脹長條矩形的像素數量。
pointStyle string|Image|HTMLCanvasElement 'circle' 圖例點的樣式。

# 弧形設定

弧形用於極地區域圖、甜甜圈圖和圓餅圖。

命名空間:options.elements.arc,全域弧形選項:Chart.defaults.elements.arc

名稱 類型 預設值 描述
angle - 僅適用於極地區域圖 number 圓周 / (弧形計數) 要覆蓋的弧形角度。
backgroundColor 顏色 Chart.defaults.backgroundColor 弧形填充顏色。
borderAlign 'center'|'inner' 'center' 弧形邊框對齊方式。
borderColor 顏色 '#fff' 弧形邊框顏色。
borderDash number[] [] 弧形虛線。請參閱 MDN (在新視窗開啟)
borderDashOffset number 0.0 弧形虛線偏移量。請參閱 MDN (在新視窗開啟)
borderJoinStyle 'round'|'bevel'|'miter' 'bevel'|'round' 線條連接樣式。請參閱 MDN (在新視窗開啟)。當 borderAlign'inner' 時,預設值為 'round'
borderWidth number 2 弧形邊框寬度。
circular boolean true boolean
上次更新: 2024/5/17 下午12:33:38