Skip to content

XY 图表

在mermaid-js的上下文中,XY图表是一个综合性的图表模块,涵盖了利用x轴和y轴进行数据表示的各种图表类型。目前,它包括两种基本图表类型:条形图和折线图。这些图表旨在直观地显示和分析涉及两个数值变量的数据。

需要注意的是,虽然当前版本的mermaid-js包含了这两种图表类型,但该框架设计为动态且适应性强的。因此,它具备扩展能力,并有望在未来包含更多的图表类型。这意味着用户可以期待XY图表模块中不断发展的图表选项,随着时间的推移,新的图表类型将被引入,以满足各种数据可视化需求。

示例

语法

信息

所有只包含一个单词的文本值都可以不用"来书写。如果文本值包含多个单词,特别是如果它包含空格,请将值用"括起来。

方向

图表可以水平或垂直绘制,默认值为垂直。

xychart-beta horizontal
...

标题

标题是图表的简短描述,它将始终显示在图表的顶部。

示例

xychart-beta
    title "This is a simple example"
    ...

信息

如果标题是单个单词,则不需要使用",但如果标题中有空格,则需要使用"

x轴

x轴主要用作分类值,但在需要时也可以作为数值范围值使用。

示例

  1. x-axis title min --> max x轴将作为数值轴,并在给定范围内起作用
  2. x-axis "title with space" [cat1, "cat2 with space", cat3] 如果是分类的x轴,类别是文本类型

y轴

y轴用于表示数值范围值,它不能有分类值。

示例

  1. y轴标题 最小 --> 最大
  2. y-axis title 它只会添加标题,范围将根据数据自动生成。

信息

如果未提供,x轴和y轴都是可选的,我们将尝试创建范围

折线图

折线图提供了以图形方式描绘线条的能力。

示例

  1. line [2.3, 45, .98, -3.4] 它可以包含所有有效的数值。

柱状图

条形图提供了以图形方式描绘条形图的能力。

示例

  1. bar [2.3, 45, .98, -3.4] 它可以包含所有有效的数值。

最简单的例子

唯一需要的两件事是图表名称(xychart-beta)和一个数据集。因此,您将能够使用简单的配置绘制图表,例如

xychart-beta
    line [+1.3, .6, 2.4, -.34]

图表配置

参数描述默认值
width图表的宽度700
height图表的高度500
titlePadding标题的上下内边距10
titleFontSize标题字体大小20
showTitle是否显示标题true
xAxisx轴配置AxisConfig
yAxisy轴配置AxisConfig
chartOrientation'vertical' 或 'horizontal''vertical'
plotReservedSpacePercent图表中绘图将占用的最小空间50

轴配置

参数描述默认值
showLabel显示轴标签或刻度值true
labelFontSize要绘制的标签的字体大小14
labelPadding标签的上下内边距5
showTitle是否显示轴标题true
titleFontSize轴标题字体大小16
titlePadding轴标题的上下内边距5
showTick是否显示刻度true
tickLength刻度线的长度5
tickWidth刻度线的宽度2
showAxisLine是否显示轴线true
axisLineWidth轴线的厚度2

图表主题变量

信息

xychart的主题位于xychart属性内,因此要设置变量,请使用此语法 %%{init: { "themeVariables": {"xyChart": {"titleColor": "#ff0000"} } }}%%

参数描述
backgroundColor整个图表的背景颜色
titleColor标题文本的颜色
xAxisLabelColorx轴标签的颜色
xAxisTitleColorx轴标题的颜色
xAxisTickColorx轴刻度的颜色
xAxisLineColorx轴线的颜色
yAxisLabelColory轴标签的颜色
yAxisTitleColory轴标题的颜色
yAxisTickColory轴刻度的颜色
yAxisLineColory轴线的颜色
plotColorPalette用逗号分隔的颜色字符串,例如 "#f3456, #43445"

配置和主题示例