跳至内容

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-axis title min --> max
  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]

图表配置

参数描述默认值
宽度图表的宽度700
高度图表的高度500
标题填充标题的顶部和底部填充10
标题字体大小标题的字体大小20
显示标题是否显示标题true
X 轴X 轴配置AxisConfig
Y 轴Y 轴配置AxisConfig
图表方向'vertical' 或 'horizontal''vertical'
绘图保留空间百分比绘图在图表内所占的最小空间50

AxisConfig

参数描述默认值
显示标签显示轴标签或刻度值true
标签字体大小要绘制的标签的字体大小14
标签填充标签的顶部和底部填充5
显示标题是否显示轴标题true
标题字体大小轴标题的字体大小16
标题填充轴标题的顶部和底部填充5
显示刻度是否显示刻度true
刻度长度刻度的长度5
刻度宽度刻度的宽度2
显示轴线是否显示轴线true
轴线宽度轴线的厚度2

图表主题变量

信息

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

参数描述
背景颜色整个图表的背景颜色
标题颜色标题文本的颜色
X 轴标签颜色X 轴标签的颜色
X 轴标题颜色X 轴标题的颜色
X 轴刻度颜色X 轴刻度的颜色
X 轴线颜色X 轴线的颜色
Y 轴标签颜色Y 轴标签的颜色
Y 轴标题颜色Y 轴标题的颜色
Y 轴刻度颜色Y 轴刻度的颜色
Y 轴线颜色Y 轴线的颜色
绘图颜色调色板用逗号分隔的颜色字符串,例如 "#f3456, #43445"

关于配置和主题的示例