Skip to Content
设计

响应式与无障碍

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,关键流程不依赖动画完成。

本页目录