# 样式
有许多选项可以用来设置坐标轴的样式。您可以设置用于控制 网格线 和 刻度 的选项。
# 网格线配置
命名空间:options.scales[scaleId].grid
,它定义了垂直于坐标轴的网格线的选项。
名称 | 类型 | 可脚本化 | 可索引 | 默认值 | 描述 |
---|---|---|---|---|---|
circular | 布尔值 | false | 如果为真,则网格线为圆形(仅适用于雷达图和极地区域图)。 | ||
color | 颜色 | 是 | 是 | Chart.defaults.borderColor | 网格线的颜色。如果指定为数组,则第一个颜色应用于第一条网格线,第二个颜色应用于第二条网格线,依此类推。 |
display | 布尔值 | true | 如果为假,则不显示此坐标轴的网格线。 | ||
drawOnChartArea | 布尔值 | true | 如果为真,则在坐标轴线内的图表区域上绘制线条。当有多个坐标轴并且需要控制绘制哪些网格线时,这很有用。 | ||
drawTicks | 布尔值 | true | 如果为真,则在图表旁边的坐标轴区域中绘制刻度旁边的线条。 | ||
lineWidth | 数字 | 是 | 是 | 1 | 网格线的笔触宽度。 |
offset | 布尔值 | false | 如果为真,则网格线将被偏移以位于标签之间。默认情况下,柱状图将此设置为 true 。 | ||
tickBorderDash | number[] | 是 | 是 | [] | 刻度标记线的长度和间距。如果未设置,则默认为网格线的 borderDash 值。 |
tickBorderDashOffset | 数字 | 是 | 是 | 刻度标记线划线的偏移量。如果未设置,则默认为网格线的 borderDashOffset 值。 | |
tickColor | 颜色 | 是 | 是 | 刻度线的颜色。如果未设置,则默认为网格线的颜色。 | |
tickLength | 数字 | 8 | 网格线绘制到坐标轴区域的像素长度。 | ||
tickWidth | 数字 | 是 | 是 | 刻度标记的像素宽度。如果未设置,则默认为网格线的宽度。 | |
z | 数字 | -1 | 网格线层的 z 索引。值 <= 0 绘制在数据集下方,> 0 绘制在数据集上方。 |
可脚本化上下文在 选项 部分中描述。
# 刻度配置
# 所有坐标轴的通用刻度选项
命名空间:options.scales[scaleId].ticks
名称 | 类型 | 可脚本化 | 默认值 | 描述 |
---|---|---|---|---|
backdropColor | 颜色 | 是 | 'rgba(255, 255, 255, 0.75)' | 标签背景的颜色。 |
backdropPadding | 填充 | 2 | 标签背景的填充。 | |
callback | 函数 | 返回刻度值的字符串表示形式,该值应显示在图表上。参见 回调。 | ||
display | 布尔值 | true | 如果为真,则显示刻度标签。 | |
color | 颜色 | 是 | Chart.defaults.color | 刻度的颜色。 |
font | 字体 | 是 | Chart.defaults.font | 参见 字体 |
major | 对象 | {} | 主刻度配置. | |
padding | 数字 | 3 | 设置刻度标签相对于坐标轴的偏移量 | |
showLabelBackdrop | 布尔值 | 是 | 径向刻度为 true ,其他情况为 false | 如果为真,则在刻度标签后面绘制背景。 |
textStrokeColor | 颜色 | 是 | `` | 文本周围笔触的颜色。 |
textStrokeWidth | 数字 | 是 | 0 | 文本周围笔触的宽度。 |
z | 数字 | 0 | 刻度层的 z 索引。当刻度绘制在图表区域上时很有用。值 <= 0 绘制在数据集下方,> 0 绘制在数据集上方。 |
可脚本化上下文在 选项 部分中描述。
# 主刻度配置
命名空间:options.scales[scaleId].ticks.major
,它定义了坐标轴生成的 主刻度标记的选项。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
enabled | 布尔值 | false | 如果为真,则生成主刻度。主刻度将影响自动跳过,并且在可脚本化选项上下文中,刻度上将定义 major 。 |
# 边框配置
命名空间:options.scales[scaleId].border
,它定义了垂直于坐标轴的边框的选项。
名称 | 类型 | 可脚本化 | 可索引 | 默认值 | 描述 |
---|---|---|---|---|---|
display | 布尔值 | true | 如果为真,则在坐标轴与图表区域之间的边缘绘制边框。 | ||
color | 颜色 | Chart.defaults.borderColor | 边框线的颜色。 | ||
width | 数字 | 1 | 边框线的宽度。 | ||
dash | number[] | 是 | [] | 网格线上的虚线的长度和间距。参见 MDN (在新窗口中打开)。 | |
dashOffset | 数字 | 是 | 0.0 | 线划线的偏移量。参见 MDN (在新窗口中打开)。 | |
z | 数字 | 0 | 边框层的 z 索引。值 <= 0 绘制在数据集下方,> 0 绘制在数据集上方。 |