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

76 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 前端界面交付自检清单
- **功能**:交付前端界面前逐项自检的清单,覆盖状态完整性、交互反馈、可访问性、动效、内容承载与表单,避免出现闪加载、无焦点环、空/错态缺失、长内容撑破等问题。
- **何时用**:改完任何有可见界面变化的代码、准备交付前;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/` 并记录评审结论。