76 lines
5.0 KiB
Markdown
76 lines
5.0 KiB
Markdown
# 前端界面交付自检清单
|
||
|
||
- **功能**:交付前端界面前逐项自检的清单,覆盖状态完整性、交互反馈、可访问性、动效、内容承载与表单,避免出现闪加载、无焦点环、空/错态缺失、长内容撑破等问题。
|
||
- **何时用**:改完任何有可见界面变化的代码、准备交付前;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/` 并记录评审结论。
|