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,關鍵流程不依賴動畫完成。

本頁目錄