当前位置: 首页 > 文档资料 > Chart.js 开发文档 >

1.4.6 通用配置(elements

优质
小牛编辑
130浏览
2023-12-01

虽然图表类型提供了设置来配置每个数据集的样式,但我们有时希望以相同的方式对所有数据集进行样式设置。常用的做法是用相同的颜色对 条形图中的所有线条进行描边来改变每个数据集的填充。

我们可以为四种不同类型的元素配置选项:arc, lines, points, 和 rectangles。当设置后,这些选项将应用于该类型的所有对象,除非被附加到数据集的配置被覆盖掉。

全局配置

元素选项可以在每个图表或全局中指定。元素的全局选项在Chart.defaults.global.elements中定义。例如,要设置全局条形图的边框宽度,可以执行以下操作:

Chart.defaults.global.elements.rectangle.borderWidth = 2;

点指示器配置

点元素用于表示折线图或气泡图中的点。

全局点指示器配置选项: Chart.defaults.global.elements.point

名称类型默认值描述
radiusNumber3半径
tyleStringcircle样式
backgroundColorColor'rgba(0,0,0,0.1)'填充色
borderWidthNumber1边框宽度
borderColorColor'rgba(0,0,0,0.1)'边框颜色
hitRadiusNumber1点击时额外增加的点半径
hoverRadiusNumber4悬浮时的点半径
hoverBorderWidthNumber1悬浮时的边框宽度

数据点样式

支持以下值:

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

如果值是图像,则使用drawImage)在canvas上绘制该图像。

折线配置

线元素用于表示折线图中的线。

全局折线配置: Chart.defaults.global.elements.line

名称类型默认值描述
tensionNumber0.4贝塞尔曲线张力 (0 表示没有)
backgroundColorColor'rgba(0,0,0,0.1)'填充色
borderWidthNumber3画笔宽度
borderColorColor'rgba(0,0,0,0.1)'画笔颜色
borderCapStyleString'butt'线帽样式 (详看 MDN).
borderDashArray[]线段 (详看 MDN).
borderDashOffsetNumber0偏移量 (详看 MDN).
borderJoinStyleString'miter'连接样式 (详看 MDN).
capBezierPointsBooleantruetrue 表示在图表内受贝塞尔曲线控制,false为没限制
fillBoolean/Stringtrue填充位置: 'zero', 'top', 'bottom', true (等于'zero') 或者 false (不填充).
steppedBooleanfalsetrue 将线显示为阶梯线(tension设置将会被忽略).

条形配置

矩形元素用于表示条形图中的条形。

全局矩形设置: Chart.defaults.global.elements.rectangle

名称类型默认值描述
backgroundColorColor'rgba(0,0,0,0.1)'填充色
borderWidthNumber0边框宽度
borderColorColor'rgba(0,0,0,0.1)'边框色.
borderSkippedString'bottom'跳过 (排除) 的边框: 'bottom', 'left', 'top' or 'right'.

弧配置

圆弧用于极地图,甜甜圈图和饼图。

全局圆弧配置: Chart.defaults.global.elements.arc.

名称类型默认值描述
backgroundColorColor'rgba(0,0,0,0.1)'填充色
borderColorColor'#fff'描边框色
borderWidthNumber2描边宽度