# 轴标签

创建图表时,您需要告知查看者他们正在查看的数据。为此,您需要给轴添加标签。

# 轴标题配置

命名空间: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 要应用于刻度标签周围的填充。仅实现 topbottomy

# 创建自定义刻度格式

您可能还希望更改刻度标记以包含有关数据类型的信息。例如,添加一个美元符号('$')。为此,您需要在轴配置中覆盖 ticks.callback 方法。

该方法接收 3 个参数

  • value - 与关联刻度相关的内部数据格式中的刻度值。对于时间刻度,它是一个时间戳。
  • index - 刻度在刻度数组中的索引。
  • ticks - 包含所有刻度对象的数组。

对该方法的调用作用域为该刻度。方法内部的 this 是该刻度对象。

如果回调返回 nullundefined,则关联的网格线将被隐藏。

提示

类别轴(它是线形图和条形图的默认 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]);

相关示例

最后更新时间: 2024 年 5 月 17 日 下午 12:33:38