# 元素
虽然图表类型提供了配置每个数据集样式的设置,但有时您希望以相同的方式对所有数据集进行样式化。一个常见的例子是,用相同的颜色描边柱状图中的所有柱子,但每个数据集的填充颜色不同。您可以为四种不同类型的元素配置选项:弧形、线、点 和 柱形。设置后,这些选项将应用于所有该类型的对象,除非数据集的配置中明确地覆盖。
# 全局配置
元素选项可以在每个图表中指定,也可以全局指定。元素的全局选项在 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
参数接受以下类型的输入:字符串
、Image
和 HTMLCanvasElement
# 信息
如果提供字符串,则支持以下值
'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 ,弧形将变平。 |