響應式與無障礙
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,關鍵流程不依賴動畫完成。