oa审批流程页应使用语义化html结构:用定义流程顺序,配合data-status属性标识节点状态,按钮按权限动态插入,历史记录用折叠,连接线用伪元素实现。

OA审批流程页不是画个带箭头的流程图就完事——它本质是状态驱动的交互界面,核心在于「当前谁能看到什么、能点什么、点了之后怎么走」。静态 HTML 圆圈+连线撑不住节点增减、驳回跳转、权限动态变化这些真实业务场景。
为什么用 <ol></ol> 而不用 <div> 套流程节点
<p>语义和可维护性直接决定后续能不能改。用 <code><ol></ol> 天然表达顺序关系,每个 <li> 对应一个审批环节,加 data-status="pending" 这类属性后,CSS 和 JS 都能精准识别当前走到哪步、哪些节点已过、哪些被跳过。
-
data-status 值建议固定为 pending / approved / rejected / skipped,别用中文或随意命名,避免 JS 判断分支爆炸
- 不要给
<li> 加 id="node1" 这种硬编码 ID,靠 data-node-id="20240520-001" 更易对接后端 API 返回结构
- 如果某节点支持多级会签(比如“法务部3人中2人同意即通过”),
<li> 内部再嵌一层 <ul class="co-signers"></ul>,比堆 <div> 更利于样式复用和屏幕阅读器识别
<h3>按钮不渲染比 <code>disabled 更安全
data-status 值建议固定为 pending / approved / rejected / skipped,别用中文或随意命名,避免 JS 判断分支爆炸<li> 加 id="node1" 这种硬编码 ID,靠 data-node-id="20240520-001" 更易对接后端 API 返回结构<li> 内部再嵌一层 <ul class="co-signers"></ul>,比堆 <div> 更利于样式复用和屏幕阅读器识别
<h3>按钮不渲染比 <code>disabled 更安全页面上放一堆 <button disabled>同意</button> 是典型假安全。用户禁用 JS 后能直接点,或者后端状态变了但前端没同步,按钮还灰着却实际能提交成功。
- 按钮初始完全不写进 HTML,等接口返回当前用户权限和节点状态后再用 JS 插入,例如:
document.querySelector('[data-node-id="20240520-001"]').insertAdjacentHTML('beforeend', '<button data-action="approve" data-node-id="20240520-001">同意</button>') - 所有操作按钮必须带
data-action和data-node-id,统一事件委托绑定,避免每个按钮单独写 click 监听 - 点击后立刻设
button.disabled = true并加 loading 状态,响应成功后整段<li>重载数据,而不是只改按钮文字或颜色
历史记录用 <details></details> 折叠,别全展开
审批人、意见、时间戳、附件这些信息,90% 场景下用户只关心当前节点和自己要干啥。全展开导致页面又长又慢,移动端尤其灾难,而且拖慢首屏渲染。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 结构按规范写:
<details><summary>2024-05-20 14:32|张三|已通过</summary><p>意见:资料齐全,同意</p>@#@#@#@#@#@#@#@#@#@0</details> - Safari 旧版本不支持
open属性自动展开,如果默认要展开最新一条,得补一句:document.querySelector('details:last-of-type').open = true - 别用 JS 模拟折叠效果,
<details></details>原生支持,无 JS 也能用,且语义正确,无障碍友好
连接线用伪元素,别用绝对定位
很多人用 position: absolute 给节点之间画线,结果一换字体、一调行高,线就偏移。伪元素方案更稳,缩放、换主题色都只改一处 CSS。
- 在 CSS 中写:
li:not(:last-child)::after { content: ""; display: block; width: 2px; height: 1.5rem; background: #e0e0e0; margin: 0 auto; } -
height用rem单位,随文字行高自适应;若需垂直居中,可用transform: translateY(-50%)配合position: relative在父<li>上 - 如果流程支持横向布局(比如宽屏看板),把伪元素改成
::before+width+height: 2px,逻辑一致,只是方向换掉
真正难的不是画出来,而是让每个节点的状态、权限、操作能力跟后端 API 返回的数据严丝合缝对上。前端一旦开始手动维护「这个按钮该不该显示」「这条线该不该画」,离不可维护就不远了。










