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