# 元素

虽然图表类型提供了配置每个数据集样式的设置,但有时您希望以相同的方式所有数据集进行样式化。一个常见的例子是,用相同的颜色描边柱状图中的所有柱子,但每个数据集的填充颜色不同。您可以为四种不同类型的元素配置选项:弧形线柱形。设置后,这些选项将应用于所有该类型的对象,除非数据集的配置中明确地覆盖。

# 全局配置

元素选项可以在每个图表中指定,也可以全局指定。元素的全局选项在 Chart.defaults.elements 中定义。例如,要全局设置所有柱状图的边框宽度,可以这样做

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

# 点配置

点元素用于表示线形图、雷达图或气泡图中的点。

命名空间:options.elements.point,全局点选项:Chart.defaults.elements.point

名称 类型 默认值 描述
radius 数字 3 点的半径。
pointStyle pointStyle 'circle' 点样式。
rotation 数字 0 点的旋转角度(以度为单位)。
backgroundColor 颜色 Chart.defaults.backgroundColor 点的填充颜色。
borderWidth 数字 1 点的描边宽度。
borderColor 颜色 'Chart.defaults.borderColor 点的描边颜色。
hitRadius 数字 1 为点击检测添加到点半径的额外半径。
hoverRadius 数字 4 鼠标悬停时的点半径。
hoverBorderWidth 数字 1 鼠标悬停时的描边宽度。

# 点样式

# 类型

pointStyle 参数接受以下类型的输入:字符串ImageHTMLCanvasElement

# 信息

如果提供字符串,则支持以下值

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

如果值是图像或画布元素,则使用 drawImage (在新窗口中打开) 在画布上绘制该图像或画布元素。

# 线配置

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

命名空间:options.elements.line,全局线选项:Chart.defaults.elements.line

名称 类型 默认值 描述
tension 数字 0 贝塞尔曲线的张力(0 表示没有贝塞尔曲线)。
backgroundColor 颜色 Chart.defaults.backgroundColor 线的填充颜色。
borderWidth 数字 3 线的描边宽度。
borderColor 颜色 Chart.defaults.borderColor 线的描边颜色。
borderCapStyle 字符串 'butt' 线帽样式。请参阅 MDN (在新窗口中打开)
borderDash number[] [] 线的虚线。请参阅 MDN (在新窗口中打开)
borderDashOffset 数字 0.0 线的虚线偏移量。请参阅 MDN (在新窗口中打开)
borderJoinStyle 'round'|'bevel'|'miter' 'miter' 线的连接样式。请参阅 MDN (在新窗口中打开)
capBezierPoints 布尔值 true true 表示将贝塞尔控制点保持在图表内部,false 表示没有限制。
cubicInterpolationMode 字符串 'default' 要应用的插值模式。 查看更多...
fill 布尔值|字符串 false 如何填充线下的区域。请参阅 面积图
stepped 布尔值 false true 表示将线显示为阶梯线(tension 将被忽略)。

# 柱形配置

柱形元素用于表示柱状图中的柱形。

命名空间:options.elements.bar,全局柱形选项:Chart.defaults.elements.bar

名称 类型 默认值 描述
backgroundColor 颜色 Chart.defaults.backgroundColor 柱形的填充颜色。
borderWidth 数字 0 柱形的描边宽度。
borderColor 颜色 Chart.defaults.borderColor 柱形的描边颜色。
borderSkipped 字符串 'start' 跳过(排除)的边框:'start''end''middle''bottom''left''top''right'false
borderRadius 数字|对象 0 柱形边框的圆角(以像素为单位)。
inflateAmount 数字|'auto' 'auto' 绘制时膨胀柱形矩形的大小(以像素为单位)。
pointStyle 字符串|Image|HTMLCanvasElement 'circle' 图例点的样式。

# 弧形配置

弧形用于极地区域图、环形图和饼图。

命名空间:options.elements.arc,全局弧形选项:Chart.defaults.elements.arc

名称 类型 默认值 描述
angle - 仅限极地区域图 数字 circumference / (弧形计数) 弧形的覆盖角度。
backgroundColor 颜色 Chart.defaults.backgroundColor 弧形的填充颜色。
borderAlign 'center'|'inner' 'center' 弧形的描边对齐方式。
borderColor 颜色 '#fff' 弧形的描边颜色。
borderDash number[] [] 弧形的虚线。请参阅 MDN (在新窗口中打开)
borderDashOffset 数字 0.0 弧形的虚线偏移量。请参阅 MDN (在新窗口中打开)
borderJoinStyle 'round'|'bevel'|'miter' 'bevel'|'round' 线的连接样式。请参阅 MDN (在新窗口中打开)。默认情况下,当 borderAlign'inner' 时,值为 'round'
borderWidth 数字 2 弧形的描边宽度。
circular 布尔值 true 默认情况下,弧形是弯曲的。如果 circular: false,弧形将变平。
上次更新时间: 2024/5/17 下午 12:33:38