响应式与无障碍
Qokit 组件和平台扩展的键盘、焦点、触控与移动端要求。
响应式与无障碍
所有公开组件和集成界面必须同时支持键盘、触控和不同语言长度。移动端应按任务重新组织布局,而不是简单缩小桌面界面。
键盘与焦点
- 使用语义 Button、Link、Label、Heading、Table 和 List;
- 所有交互都能通过键盘到达和操作;
- 使用共享
focus-visible与--focus-ring,不得移除焦点反馈; - IconButton 必须提供本地化
aria-label; - Tooltip 只能补充说明,不能替代可访问名称。
触控与状态
- 紧凑控件点击区域不低于 40px,移动端主要操作不低于 44px;
- Hover 不能成为唯一提示;
- Disabled、Loading、Empty 和 Error 状态必须有可理解的反馈;
- 危险操作使用明确文案和确认流程,不能只依赖红色。
响应式布局
- 平板以下的分栏界面按任务优先级切换为单列、折叠或抽屉;
- Header、Toolbar、表格、预览框和操作组保持稳定尺寸;
- 长标签、翻译文本和用户内容不得覆盖相邻操作;
- 桌面与移动端都要验证真实内容、焦点顺序和横向溢出。
内容与对比度
- 正文、说明和 CTA 在浅色、深色与主题化背景上保持可读;
- 图片提供与内容相符的替代文本;
- 状态不能只通过颜色表达;
- 动效尊重
prefers-reduced-motion,关键流程不依赖动画完成。