ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

3分钟上手 Mermaid.js 饼图与柱状图:一张对比表帮你选型

3分钟上手 Mermaid.js 饼图与柱状图:一张对比表帮你选型 3分钟上手 Mermaid.js 饼图与柱状图一张对比表帮你选型【免费下载链接】mermaidGeneration of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown项目地址: https://gitcode.com/GitHub_Trending/me/mermaid周报要交图还没画一张各产品线销售额的占比图再加一张近 6 个月的销售对比。用设计工具导出要折腾半天用 Mermaid.js 饼图画占比、用 xychart-beta 柱状图做对比两段文本代码就能把整份周报的数据可视化写完。 先跑通再深入先别背语法把一个最小 HTML 存成pie.html浏览器打开就能看到图。它做了两件事引入 Mermaid 库然后调用mermaid.initialize({...})启动渲染!DOCTYPE html html head meta charsetutf-8 / script srchttps://cdn.jsdelivr.net/npm/mermaid10/dist/mermaid.min.js/script script mermaid.initialize({ theme: default }); /script /head body pre classmermaid pie showData title 各产品线销售额占比 云服务 : 42 硬件 : 31 软件 : 19 服务 : 8 /pre /body /html页面里会出现一个 4 块扇区的饼图扇区角度按数值比例分配title是图表标题showData让图例后面显示具体数值。如果你不想搭 HTML也可以直接用官方演示页里的同款代码。饼图语法骨架pie showData title一个饼图的全部骨架如下4 行就能出图各部分的可写性很明确pie是唯一必填的起始关键字showData可选加上后图例会显示数值title可选用于图表标题标签 : 数值是数据行至少 1 行数值必须是大于 0 的正数最多支持 2 位小数扇区会按标签出现的顺序顺时针排列排在前面的数据想让它先画就写在前面。标签重叠或被边缘裁掉时你可以用textPosition这一个参数调整标签的径向位置0.0 是圆心1.0 是外圈边缘默认 0.75。把标签往圆心或外圈挪一格拥挤就解决了想换配色用主题变量即可pie1到pie12控制扇区填充色pieOuterStrokeWidth控制外描边粗细默认 2px。写法是在图表前加一个config块两个贴近业务的例子。第一个是市场份额类别天然加总到 100%加showData让读者能直接核对数字第二个是预算分配数据是绝对金额重点是比例而非数值去掉showData图面更干净柱状图语法骨架x-axis、y-axis 与 barxychart-beta 柱状图的骨架是 5 行。其中硬性要求其实只有两条图表名xychart-beta和至少一个数据系列其余都可选x-axis放分类数组含空格的分类要加引号y-axis写数值量程格式是标题 最小值 -- 最大值只写标题不写量程也可以范围会按数据自动生成但手动给出量程能避免柱子顶天立地bar后面跟数值数组数据项个数要和 x 轴分类对齐title多词时用引号包起来。注意y-axis的量程要和数据匹配上面 6 个值最大 10.5量程写到12刚好留一点余量写成0 -- 99999会让所有柱子缩成一小截。水平柱状图写法xychart-beta horizontal加一个horizontal关键字x 轴和 y 轴的角色对调x 轴变数值量程y 轴变分类。适合分类名较长、竖着放会被压缩的场景多系列对比柱状图写法写多条bar数据就能做多系列对比。给每条系列加一个名字bar 系列名 [...]图例会自动出现读者知道每种颜色对应哪一年bar line 组合图表写法同一张图里混写bar和line就是组合图。典型用法柱子放绝对量销售额折线放派生指标利润一眼看出两者的差距变化用 config 块定制柱状图尺寸样式自定义走config块即可width/height控制画布大小默认 700×500showDataLabel让每根柱子顶部显示数值titleFontSize调标题字号。配色则放在同一块的themeVariables.xyChart下plotColorPalette用逗号分隔的颜色串按顺序分配给各系列选饼图还是柱状图4个维度对比表维度Mermaid.js 饼图xychart-beta 柱状图数据形态部分占整体的比例绝对数值可并排对比类别数量6 个以内为佳多了扇区太薄7 个以上也清晰是否需要趋势不能表达时间趋势可以x 轴按月/季排列精确比较弱靠目测扇区角度强可结合量程与数据标签读数一句话口诀占比看饼比大小看柱看趋势柱上加线。 高频踩坑与排查现象饼图渲染报错图出不来。原因数据里混进了 0 或负数饼图只接受大于 0 的正数。 解法把异常类别并入其他或改画柱状图bar 支持负值。现象纠结数值加起来必须等于 100 才敢画饼图。原因担心比例不对。实际上扇区角度由各项在总和中的占比自动算出总和不必是 100。 解法直接填绝对值showData显示原始数值占比交给读者看扇区。现象扇区标签互相重叠、或被裁到图外。原因标签默认落在径向 0.75 的位置类别多且扇区薄时容易挤。 解法调textPosition往 0.0 方向收拢到圆心附近或推到 1.0 贴近外圈再缩短标签文字。现象同一段 xychart-beta 代码文档里能渲染CDN 页面却报解析错误。原因CDN 锁定的 mermaid 版本过旧不支持 XY 图表或新语法另外官方文档中xychart与xychart-beta两种拼写并存beta 是早期引入时的历史命名。 解法升级 CDN 版本到支持该语法的版本排查时先核对页面里 script 标签的版本号。资料索引入门指南引入方式与 initialize 用法docs/intro/getting-started.md饼图语法参考docs/syntax/pie.mdXY 图表语法参考docs/syntax/xyChart.md完整配置项docs/config/configuration.md主题变量说明docs/config/theming.md饼图演示页demos/pie.html柱状图演示页demos/xychart.html社区贡献指南CONTRIBUTING.md打开你的 Markdown 编辑器或 HTML 文件把开头那段饼图代码贴进去现在就把你的周报饼图画出来。【免费下载链接】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),仅供参考
返回列表