界面质感 是做什么的?
界面如何移动和响应的主控通杀。它根据40项检查(12个动画原则、8个UX法则、20个UI技术)和运动系统,审计应用当前的表现,编写报告,然后按照每个项目的模式进行修复。大多数应用已经拥有一半的清单项;审计会如实指出,而非重复添加。速度、点击目标和信任始终适用;装饰性处理在工作工具中保持克制。
项目自身的设计系统、运动令牌和规则优先于此处任何内容。性能预算(LCP、INP、包体积)、无障碍和文案应作为独立的通行证与此并存。
此技能包含的文件
| 文件 | 用途 |
|---|---|
reference.md | 40个检查项:如何检查、修复模式、何时跳过、真实审计发现 |
motion.md | 运动系统:令牌、十二条规则、CSS模式、如何审计动效 |
audit/census.sh | 代码普查:统计每个检查项背后的模式,附带文件:行 定位 |
audit/probe.js | 实时页面探测:真实点击目标尺寸、时长、缓动、数字、标题、代码字段、占位符 |
report-template.md | 审计报告模板:每个检查项一行结论、工作顺序、未检查项 |
第一阶段:审计(不修改任何内容)
- 首先阅读项目的设计系统、运动令牌和UI规则。
- 在项目根目录运行代码普查:
bash <此技能路径>/audit/census.sh . --show 5。它仅读取已上线的表面内容(排除依赖、构建产物、副本、测试、基准测试、生成文件和注释行;可通过CENSUS_EXCLUDE="dir1,dir2"添加更多排除)。安装 ripgrep 可加速运行;否则脚本将回退到 perl。计数是定位线索,而非最终结论。 - 运行应用。在每个关键页面运行
audit/probe.js(粘贴到控制台,或在浏览器工具的JavaScript运行器中await它),分别在1440px和375px宽度下,以及应用的每个主题中运行。它会逐屏滚动整个页面并恢复滚动位置。隐藏的标签页没有宽度且不渲染帧:请先显示它。解读输出时需判断:标记为spaced的目标(与下一个控件的间距达到下限)严重性较低;数字仅在变化时才需要tabular-nums;将装饰性模拟窗口标记为aria-hidden或忽略其行。 - 手动驱动脚本无法看见的交互,需使用真实的指针事件(浏览器工具的点击,而非合成的
.click()):对每个付费或不可逆操作快速双击,统计服务器端效果;将网络和写入操作限速至600ms后再点击;快速打开和关闭每个层并中途重新打开,采样其不透明度(参见motion.md中的 "Measuring a reopen");在关闭的菜单内部点击;输入带重音和不同大小写的查询;沿着对角线移向悬停子菜单;在层打开时按下Android返回键;滑动手机弹窗。 - 根据
report-template.md编写报告:全部40行,每行标记为 存在、缺失、错误 或 跳过,并附理由、证据(文件:行或数值),以及 构建 或 挑选。在修复前展示报告。
第二阶段:按清单修复
- 信任优先:第39项及任何可能导致双重收费或数据丢失的问题,需在修复前编写能测试失败的测试用例。
- 构建项:改变行为但不改变外观(触摸扩展、安全三角区、返回手势、重音折叠、快捷键、命令菜单条目、乐观写入、骨架屏、动效令牌、可逆过渡)。根据
reference.md和motion.md中的模式,通过项目自身的组件和令牌进行修复,并为所有逻辑添加测试。 - 挑选项:改变外观或产品特性(圆角、模糊占位符、用撤销替代确认、错误提示、新的动效节奏、视图过渡)。分别在两个主题下,按1倍比例对每项进行前后对比基准测试,编号且可分离;仅构建产品负责人挑选的项目。
- 切勿用移除的装饰来替换新的装饰。
第三阶段:验证
重新运行代码普查和实时探测,将数值与报告对比。以用户真实使用的方式,在两个主题下以及手机宽度下分别驱动每个已修复的交互。将已构建、已测试、已视觉批准和已部署作为独立事实报告,并说明哪些内容无法测量(无实体手机、无生产构建)。
清单
编号与 reference.md 及报告一致。
| # | 检查项 | 失败条件 |
|---|---|---|
| A | 动画原则 (motion.md) | |
| 1 | 挤压与拉伸 | 着陆徽章、圆点或旋钮停止时僵硬 |
| 2 | 预备动作 | 按下后一帧内无状态变化(缩放约0.97,约100ms) |
| 3 | 呈现 | 打开的层让主要内容不清晰 |
| 4 | 姿态到姿态 | 繁忙的按钮、标签或图标切换时宽度或内容跳跃 |
| 5 | 跟随动作 | 层的内容与容器同时到达,没有先后 |
| 6 | 缓入缓出 | UI动效使用 linear 或默认 ease;超过三种缓动函数 |
| 7 | 弧线 | 某元素沿直线长距离移动 |
| 8 | 次级动作 | 完成的操作没有确认性的第二拍 |
| 9 | 干脆的时机 | UI响应超过300ms;同一界面中存在不一致;退出时间未更短 |
| 10 | 夸张反馈 | 无效提交仅显示微动,无色彩变化 |
| 11 | 立体绘画 | 阴影和图层在光照和深度上不一致 |
| 12 | 吸引力 | 一个真实流程,按1倍比例分步播放,暴露接缝 |
| B | UX法则 | |
| 13 | 菲茨定律 | 桌面端真实目标小于32px,或手机端小于44px |
| 14 | 更大的点击区域 | 通过放大图片增大目标,或兄弟元素重叠 |
| 15 | 希克定律 | 单个菜单块中超过五个项目 |
| 16 | 米勒定律 | 超过约七个未分块的一级项目 |
| 17 | 多尔蒂定律 | 从按下到下一帧绘制超过400ms,且无任何首次响应 |
| 18 | 波斯特尔定律 | 查询的重音、大小写或间距变体找不到结果 |
| 19 | 雅各布定律 | 模式行为与平台不一致(悬停子菜单、返回关闭层) |
| 20 | 使用频率 | 日常操作需要多于一步或一个命令才能完成 |
| C | 速度与反馈 | |
| 21 | 骨架屏加载 | 路由渲染空白或点击帧显示加载动画 |
| 22 | 乐观更新 | 便宜的、可逆的写入在服务器响应前无任何显示 |
| 23 | 命令菜单 | 某个目的地可通过点击到达,但无法通过键盘输入到达 |
| 24 | 快捷键提示 | 有快捷键的控件在工具提示中未显示该快捷键 |
| 25 | 撤销提示 | 可恢复的删除操作没有撤销选项(由产品负责人决定是否替代确认框) |
| 26 | 用旧数据立即刷新 | 重新访问的页面等待而非立即显示上次数据 |
| 27 | 预渲染 | 可能的下一页未在意图明确时预取(在生产环境中判断) |
| 28 | 模糊占位符 | 加载中的图片是灰色方框 |
| 29 | 视图过渡 | 网格到详情的打开没有共享元素变形效果 |
| 30 | 滑动关闭 | 手机弹窗或抽屉无法通过滑动关闭 |
| 31 | 可中断动画 | 在退出动画期间重新打开,从头播放 |
| D | 平台与细节 | |
| 32 | 预测性返回 | Android返回键在层打开时离开当前页面 |
| 33 | 触摸扩展 | 小图标控件没有不可见的目标扩大区域 |
| 34 | 安全区域边距 | 底部浮动元素未使用 env(safe-area-inset-*) 且未设置 viewport-fit=cover |
| 35 | 一次性验证码自动填充 | 验证码输入框缺少 autocomplete="one-time-code" 和 inputmode="numeric" |
| 36 | 等宽数字 | 变化的数字抖动(未使用 tabular-nums) |
| 37 | 平衡标题 | 短的多行标题出现孤行(未使用 text-wrap: balance) |
| 38 | 连续圆角 | 未考虑方圆形圆角(外观决策:进行基准测试) |
| E | 信任 | |
| 39 | 幂等性键 | 对付费或不可逆操作的两次快速点击导致两个服务器端效果 |
| 40 | 安全三角区 | 悬停子菜单在向它对角线移动时关闭 |
常见错误
- 添加已存在的内容:骨架屏、缓存和动效令牌通常已经存在;结论应为存在。
- 将客户端去重作为唯一的防护手段:两次点击发生在重新渲染禁用按钮之前。应在服务器端防护(条件更新、确定性键、锁),并在 ref 中保持按下状态。
- 放大图片而非扩大目标区域;仅在桌面宽度下检查目标,而桌面规则可能压低了手机端的最小尺寸。
- 使用关键帧实现打开和关闭动画:它们无法反向。应使用状态属性上的过渡,并将离开的层设为
inert。 - 将撤销、圆角或错误提示音视为纯工程决策。它们属于产品负责人。
- 在开发服务器或后台标签页中判断预取或计时。