尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

如何在 Mermaid 里轻松画好饼图与柱状图:从语法到实战的完整指南

如何在 Mermaid 里轻松画好饼图与柱状图:从语法到实战的完整指南 如何在 Mermaid 里轻松画好饼图与柱状图从语法到实战的完整指南【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid周报快交了你想在文档里塞一张渠道占比的饼图、再配一张按月对比的柱状图却还在 PPT 和 Excel 之间来回切换。Mermaid.js 是一个开源的 JavaScript 图表库用 Markdown 风格的文本描述数据它直接渲染出 SVG 图表。饼图和柱状图各只需几行代码写完即所见。饼图基础语法四行文本出一张饼先从一个最常见的场景入手展示订单来自哪些渠道。下面这段定义可以直接放进任何支持 Mermaid 的环境规则很简单pie开头可选地跟showData在图例旁显示数值和title标题之后每行一个标签 : 数值。切片按书写顺序顺时针排布。官方语法细节可查 docs/syntax/pie.md。给你一张语法速查表片段作用是否必需pie图表起始关键字是showData图例中显示具体数值否title 标题图表标题否标签 : 数值一个数据切片正数、最多两位小数是记住两条硬约束数值必须是大于 0 的正数负数会直接报错含空格的标签要加引号。柱状图数据写法轴、bar 与 series要对比不同类别的数值用xychart-beta较新版本中xychart这个关键字同样有效解析器两者都接受。先看一个最近 6 个月活跃用户的例子它的骨架是四类语句title ...标题含空格时加引号x-axis [类别1, 类别2, ...]x 轴放类别用方括号列出y-axis 名称 最小值 -- 最大值y 轴是数值范围--分隔上下界bar [...]数据数组顺序与类别一一对应写成bar 系列名 [...]则进入图例。最简形态其实只有两行——图表关键字加一个数据集缺省的轴范围会自动推断。完整规则见 docs/syntax/xyChart.md。进阶用法组合图、水平图与主题定制一张图说两件事bar line 组合图柱状图看绝对量折线图看趋势两者可以画在同一坐标系里。下面的例子用同一把标尺同时呈现订单量与客单价注意两组数据的单位要协调否则折线会被压成一条直线命名过的bar和line都会自动出现在图例中无需额外声明。水平柱状图类别名太长也不怕垂直柱状图里横轴的长标签容易互相重叠。把horizontal关键字放在图表名后面即可翻转方向类别名移到左侧纵向排列注意横向模式下类别依然写在x-axis里y-axis永远是数值范围这一点和垂直模式完全一致。用 themeVariables 定制图表主题样式不必写进图表正文。在图表定义前放一段 YAML frontmatter就能单独控制这一张图的尺寸、数据标签和配色——plotColorPalette里的颜色按系列出现顺序依次分配showDataLabel: true会把每根柱子对应的数值直接标在柱体上省掉读者目测刻度这一步。可定制的变量标题色、轴颜色、背景色等完整列表在官方文档里有表格主题相关源码位于 packages/mermaid/src/diagrams/xychart/。把图表嵌入 Markdown 与网页文档平台直接写。如果你的写作环境博客、知识库、静态站点生成器支持 Mermaid 语法把上面的定义包进mermaid代码围栏就能渲染数据与文档同在一份文件里改动即可重新渲染天然适合版本管理。HTML 页面两件事。一是把图表文本放进带mermaid类的pre标签二是引入 Mermaid 脚本。项目里 demos/pie.html 和 demos/xychart.html 就是现成参照pre classmermaid pie title 收入来源分布 产品销售 : 45 订阅服务 : 30 咨询服务 : 15 培训收入 : 10 /pre script typemodule import mermaid from https://cdn.jsdelivr.net/npm/mermaid11/dist/mermaid.esm.min.mjs; mermaid.initialize({ startOnLoad: true, theme: default }); /script想本地把玩可以克隆仓库。执行git clone https://gitcode.com/GitHub_Trending/me/mermaid用 pnpm 安装依赖后跑起本地开发页即可边改文本边看效果。常见错误清单与一分钟自检常见错误清单饼图出现负数或零解析直接失败所有切片必须是正数最多两位小数。轴范围写错方向范围分隔符是--不是或-。y 轴写了类别列表y-axis只接受最小值 -- 最大值的数值范围类别永远属于x-axis。数据个数与类别个数不一致多一个或少一个柱子和类别就会悄悄错位务必数一遍。多词标签忘加引号x-axis [单元测试, 集成测试]中的单元测试应写作单元测试。数值超出轴上限柱子/折线会被截断确认y-axis上限盖住最大数据。一分钟自检提交图表前花一分钟过一遍首行是pie还是xychart-beta与图表类型匹配每个bar/line数组长度等于类别数量轴范围覆盖全部数据方向是从小到大所有含空格的标题与标签都加了引号。三个高频问题饼图上的数值怎么显示在pie后面加showData图例旁就会出现数值。能不能不写轴可以。xychart-beta加一个数据集就是最简形态范围由数据自动推断写轴只是把控制权拿回自己手里。xychart-beta和xychart该用哪个当前版本的词法解析见 packages/mermaid/src/diagrams/xychart/parser/xychart.jison两个关键字都识别混用不会报错新项目里统一用一个即可。图表的本质是把几行文本变成可评审、可 diff 的图形资产。掌握上面这几组写法饼图讲占比、柱状图做对比、组合图补趋势日常文档里的数据表达基本就够用了。接下来可以去 docs/ 逛逛其他图表类型的语法你会发现它们共享同一套文本即图表的思路。【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表