响应式 UI 质量检查
在实现或修改前端页面、组件、游戏或交互式工具后使用此技能。
工作流程
- 必要时使用仓库的正常命令启动应用。
- 至少检查以下视口:移动端
375x812、平板768x1024、桌面1440x900,以及一个狭窄的极限宽度320px。 - 对每个关键路由/状态进行截图或使用浏览器检查。
- 检查是否存在重叠、文本裁剪、水平滚动、不可读的对比度、过小的点击目标、破损的粘性元素、空白的媒体/Canvas、以及隐藏在固定 UI 后的内容。
- 与导航、菜单、表单、标签页、对话框、悬停/焦点状态以及主要 CTA 进行交互。
- 使用响应式约束、网格调整、换行、最小/最大宽度、稳定的高度和溢出处理来修复布局。
- 在之前失败的视口/状态下重新测试。
- 对于 Canvas/3D/媒体体验,验证像素非空且场景正确取景。
修复偏好
- 使用容器相对尺寸、
minmax()、clamp()处理尺寸、aspect-ratio和显式网格轨道。 - 不要直接根据视口宽度缩放字体大小。
- 优先使用换行和回流,而不是缩小文本至不可读。
- 仅对控件、工具栏、媒体框和已知格式的表面保留固定高度。
- 确保键盘焦点可见且未被裁剪。
参考
在执行最终视觉质量检查时,阅读 references/qa-checklist.md。