ol标签无法制作真正的工作流程图,仅能语义化编号文字步骤;需用Mermaid等工具绘制带节点、箭头、分支的流程图,ol仅适合作为流程图下方的文字指引或可访问性清单。

ol 标签本身不能制作工作流程图,它只负责按顺序编号展示文字步骤;真要画带箭头、节点、分支的流程图,得用 Mermaid、Flowchart.js 或 SVG/Canvas 手绘。
为什么直接用 ol 写不出流程图
浏览器把 ol 当作语义化文本容器,只渲染编号 + 文字,不理解“开始→判断→分支→结束”这类逻辑关系。你写:
<ol> <li>用户登录</li> <li>验证权限</li> <li>跳转首页或报错</li> </ol>
结果只是三行带数字的纯文本,没有连线、没有菱形判断框、也没有条件分支视觉提示。
常见错误现象:ol 嵌套 ul 模拟分支(比如在第2项里列“成功→… / 失败→…”),但屏幕阅读器和 SEO 会把它当成两层列表,语义混乱;CSS 也很难对齐箭头或缩进模拟流程走向。
用 Mermaid 快速生成可运行的工作流程图
Mermaid 是目前最轻量、无需构建、直接写文本就能出图的方案,适合嵌入 HTML 页面快速交付。
- 在
中引入 Mermaid:<script type="module" src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs"></script> - 初始化配置(防止首次渲染失败):
mermaid.initialize({ startOnLoad: true }); - 在
中放一个容器,里面写 Mermaid 语法:classDiagram User -->|login| AuthModule AuthModule -->|check| PermissionService PermissionService -->|allow| HomePage PermissionService -->|deny| ErrorPage或者更贴近步骤流的
flowchart TD:flowchart TD A[用户访问] --> B{是否已登录?} B -- 是 --> C[加载主页] B -- 否 --> D[跳转登录页] D -- 提交成功 --> C保存为 .html 文件,用浏览器打开即可渲染成矢量流程图——支持缩放、无障碍标签、暗色模式自动适配。
ol在流程图场景中唯一靠谱的用途它不是流程图绘制工具,而是流程说明的辅助载体,适合放在流程图下方或侧边栏,做「文字版操作指引」或「可复制的执行清单」。
- 配合 Mermaid 图使用时,
ol可列出每步对应的操作命令(比如 CI/CD 流程图旁附:)- git push
- 触发 GitHub Actions
- 部署到 staging
- 需要打印或导出纯文本流程时,
ol+start属性能保证编号连续:- 构建 Docker 镜像
- 若后端返回的是步骤数组,前端用
ol渲染比拼接字符串更利于可访问性(role="list"和role="listitem"自动生效)
别试图用 CSS 把
ol的li旋转 45 度加伪元素画箭头——布局易塌、缩放失真、打印空白、手机横屏错位,这些坑都踩过。 - 配合 Mermaid 图使用时,
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











