Files
lpt-fe/roles/ui-review-checklist.md

5.0 KiB
Raw Permalink Blame History

前端界面交付自检清单

  • 功能:交付前端界面前逐项自检的清单,覆盖状态完整性、交互反馈、可访问性、动效、内容承载与表单,避免出现闪加载、无焦点环、空/错态缺失、长内容撑破等问题。
  • 何时用:改完任何有可见界面变化的代码、准备交付前;code review 前端改动时;补 e2e 用例时。

规则

状态完整性(每处都要有)

  • 五态齐备:空 / 稀疏 / 密集 / 加载 / 错误。空态给下一步动作(el-empty + 主按钮),错误态给可读原因 + 重试按钮,且错误与空数据分开(不要用同一个空态兜住失败)。
  • 加载不闪:进度指示延迟 ~150–300ms 才显示,并保证最短可见 ~300–500ms;快响应不出现「闪一下」的 spinner。
  • 骨架/占位与最终内容形状一致,不造成内容跳动。
  • 加载失败可恢复:保留 loadFailed 状态,重试前重置该状态,不只靠 finally 关 loading 留白屏。

交互与反馈

  • 可点元素看得出可点;悬停才出现的入口,触屏与键盘也能到达。
  • 状态变化时点击区域不变大变小,也不挤动旁边布局。
  • 异步按钮:请求期间自身 loading 或禁用;loading 时保留原文案,只加 spinner。
  • 提交按钮保持可用直到请求真正开始,不在填表期间预先禁用。
  • 破坏性操作有确认,或提供 Undo 窗口;危险动作视觉上与主操作分离(type="danger")。
  • 提示/toast 3–5 秒自动消失;toast 不抢焦点。
  • 表单校验在失焦时给结论(不要在每次按键时就报错);字段多时提交失败后聚焦第一个错误处。
  • 未保存内容在离开前有提示。

可访问性(底线,不是加分项)

  • 全流程键盘可达;Tab 顺序与视觉顺序一致。
  • 每个可聚焦元素有 :focus-visible 焦点环;粘性头部/底部、遮罩不得盖住获得焦点的控件。
  • 弹窗:焦点进入时被约束在弹窗内、Esc 可关、关闭后焦点归还触发元素。
  • 纯图标按钮有可访问名称(aria-label);装饰性图标 aria-hidden="true"。
  • 图标按钮与行内控件的指针目标 ≥24px(移动端 ≥44px);视觉小于此值时扩大命中区。
  • 语义元素优先(button / a / label),次选 ARIA;标题层级 h1→h6 不跳级。
  • 状态不只靠颜色传达(配色 + 文字或图标)。
  • 文字对比 ≥4.5:1;非文字(图标、边框、图表)对比 ≥3:1。

动效

  • 显式列出过渡属性(transition: opacity .2s ease, transform .2s ease);禁止 transition: all。
  • 只动 transform / opacity,不动 width / height / top / left。
  • 尊重 prefers-reduced-motion(可动效果在 reduce 下停用或大幅减弱)。
  • 动效可被用户操作打断;不阻塞输入。
  • 只动 1–2 处关键元素表达因果,不做全页统一淡入上移。

内容承载

  • 长内容不撑破布局:min-width: 0 + 省略/换行/overflow-wrap: anywhere;URL、ID、用户输入按最长情况验证过。
  • 截断时保留看全文的入口,且相近内容截断后仍能区分。
  • 上下比较的数字(统计、金额、计时、覆盖率)用 font-variant-numeric: tabular-nums。
  • 日期、时间、数字用本地化格式(Intl.DateTimeFormat / Intl.NumberFormat),不手拼字符串。
  • 文案用 …(省略号字符)而不是 ...;加载态文案以 … 结尾(「加载中…」「生成中…」)。
  • 中文断行受控:数字与单位、「不会」这类不可拆词不换行;行末不留孤字。

表单

  • 每个输入有可见 label(不用 placeholder 代替 label)。
  • 用语义 type(email / tel / number)与 inputmode 触发正确键盘。
  • 错误就近字段显示并与之关联;复杂输入提供常驻帮助文字,不靠 placeholder。
  • 不用 placeholder 承载必要信息;placeholder 用示例值。
  • 不阻止输入(包括粘贴)、不预先禁用提交;校验放在输入之后。
  • 禁用态与只读态在视觉与语义上可区分。

移动端与布局

  • 375px 宽与横屏下可读、可操作;无横向滚动。
  • 固定头/底栏给内容留出内边距,列表不被遮挡。
  • 移动端输入框字号 ≥16px(避免 iOS 聚焦缩放)。
  • 弹窗宽度 calc(100% - 24px),footer 按钮全宽纵向堆叠(全局规则已在 main.css,新增弹窗无需重写)。
  • 断点遵循既有口径:按钮/弹窗 768px,卡片与汇总布局 900px。

交付前

  • npm run type-check、npm run lint(0 error)、npm run test 全绿。
  • 关键路径有交互式集成测试(src/__tests__/integration/),只断言应用自身行为。
  • 改动涉及新页面或大范围 UI:已走 skills/ui-review/ 并记录评审结论。