# 轴标签
创建图表时,您需要告知查看者他们正在查看的数据。为此,您需要给轴添加标签。
# 轴标题配置
命名空间:options.scales[scaleId].title
,它定义了轴标题的选项。注意,这仅适用于笛卡尔坐标系轴。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
display | boolean | false | 如果为 true,则显示轴标题。 |
align | string | 'center' | 轴标题的对齐方式。可能的选项有 'start' 、'center' 和 'end' |
text | string |string[] | '' | 标题的文本。(例如,“人数”或“响应选项”。) |
color | Color | Chart.defaults.color | 标签的颜色。 |
font | Font | Chart.defaults.font | 参见 字体 |
padding | Padding | 4 | 要应用于刻度标签周围的填充。仅实现 top 、bottom 和 y 。 |
# 创建自定义刻度格式
您可能还希望更改刻度标记以包含有关数据类型的信息。例如,添加一个美元符号('$')。为此,您需要在轴配置中覆盖 ticks.callback
方法。
该方法接收 3 个参数
value
- 与关联刻度相关的内部数据格式中的刻度值。对于时间刻度,它是一个时间戳。index
- 刻度在刻度数组中的索引。ticks
- 包含所有刻度对象的数组。
对该方法的调用作用域为该刻度。方法内部的 this
是该刻度对象。
如果回调返回 null
或 undefined
,则关联的网格线将被隐藏。
提示
类别轴(它是线形图和条形图的默认 x 轴)使用 index
作为内部数据格式。要访问标签,请使用 this.getLabelForValue(value)
。 API:getLabelForValue
在以下示例中,Y 轴的每个标签都将在前面显示一个美元符号。
const chart = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
y: {
ticks: {
// Include a dollar sign in the ticks
callback: function(value, index, ticks) {
return '$' + value;
}
}
}
}
}
});
请记住,覆盖 ticks.callback
意味着您要负责标签的所有格式化。根据您的用例,您可能希望调用默认格式化程序,然后修改其输出。在上面的示例中,这将类似于
// call the default formatter, forwarding `this`
return '$' + Chart.Ticks.formatters.numeric.apply(this, [value, index, ticks]);
相关示例