轴

快速入门

editor.commands.updateChartAxis({ axis: 'y', changes: { step: 25 } })
editor.commands.updateChartAxis({ axis: 'x', changes: { labels: { angle: 45 } } })

轴字段

x 是类别轴，y 是值轴。当杠横放时，这种情况保持不变。

网格和轴线

grid 和 line 各自是一个 ChartStroke，一个说明如何绘制一条线的对象：

如果没有 grid 和 line，图表将具有：

• 其值处的网格线，
• 其类别处没有网格线，除非当类别是散点图上的数字时，
• 为类别轴线，
• 无值轴线。

当网格线被省略时

当网格线位于轴线之上时，仅绘制轴线。因此，值网格没有类别轴延伸的线，并且类别网格没有沿着值轴的线。如果使用 x.line: { line: 'none' } 隐藏类别轴，则图表底部根本没有线条。

当值低于 0 时，类别轴在 0 处穿过绘图。然后值网格将其线保持在最低值。

某些类别的网格线

类别网格 (x.grid) 也采用 every 和 at：

在条形图上，类别网格线沿着条形的边缘延伸，因此线条数比类别数多。对于 every 和 at，最后一个柱右边缘的线算作下一个类别。如果有 4 个条，则为数字 4。

值网格不包含任何字段。 x 轴上有数字的散点图两者都不会。

editor.commands.updateChartAxis({
  axis: 'y',
  changes: { grid: { line: 'dotted', color: '#94a3b8' } },
})
editor.commands.updateChartAxis({ axis: 'x', changes: { grid: { line: 'solid', width: 0.5 } } })
editor.commands.updateChartAxis({ axis: 'x', changes: { grid: { line: 'solid', every: 3 } } })

类别标签

x.labels 是 CategoryLabels 对象。对于狭窄图表上的长标签，它会省略或翻转类别标签。 every 和 at 选择类别，就像它们对网格线 所做的那样。

• 仅保留标签。类别、栏目和分数均保留。
• 在 angle: 45，标签向右上升并在其类别处结束，因此长名称可以并排放置。
• 如果没有 every 或 at，则会忽略重叠的标签。

editor.commands.updateChartAxis({ axis: 'x', changes: { labels: { every: 3 } } })

勾选步骤

y.step: 25 在 0、25、50 等处放置勾选、标签和值网格线。

• 轴的两端均舍入为整步，除非 min 或 max 修复它们。
• 会忽略超过 100 个刻度的步骤。
• 在具有第二个轴的组合图表上，该步骤适用于左侧轴。

哪些图表绘制轴

折线图、条形图、面积图、散点图和组合图占据每个字段。雷达图需要两个：y.grid 设置环，x.line 设置辐条。两者都是默认绘制的。

ECharts 和 D3 渲染器绘制每个字段。Mermaid渲染器拒绝设置它们的图表，请参阅其limits。您自己的渲染器可以像内置渲染器一样绘制轴，请参阅spec 中应遵循的内容]。

在 Word 文档中

Word 绘制规范设置的内容和 every，但不绘制 at。

• 当它是 #rrggbb 值时使用颜色。否则，Word 将使用主题的颜色。
• 设置为 'none' 的类别轴线保持网格线沿着它。
• step 成为值轴的主要单位。
• labels.every 成为标签跳过。
• labels.angle 成为标签的旋转。
• labels.at 在 Word 中没有对应项，因此 Word 会写入每个标签。

命令

updateChartAxis

更改 spec.axes.x 或 spec.axes.y 的字段并保留其余字段。设置为 undefined 的字段被删除。

editor.commands.updateChartAxis({ axis: 'y', changes: { title: 'EUR', min: 0 } })

当 pos 处没有图表或未选择任何图表时，返回 false。