レスポンシブとアクセシビリティ
Qokit コンポーネントおよびプラットフォーム拡張のキーボード、フォーカス、タッチ、モバイル要件。
レスポンシブとアクセシビリティ
すべての公開コンポーネントと統合インターフェースは、キーボード、タッチ、異なる言語の文字長に対応する必要があります。モバイルでは、デスクトップインターフェースを単純に縮小するのではなく、タスクに基づいてレイアウトを再構成します。
キーボードとフォーカス
- セマンティックな Button、Link、Label、Heading、Table、List を使用します;
- すべてのインタラクションはキーボードで到達・操作可能である必要があります;
- 共有
focus-visibleと--focus-ringを使用し、フォーカスフィードバックを削除しないでください; - IconButton にはローカライズされた
aria-labelを必須で提供します; - Tooltip は補足説明としてのみ使用し、アクセシブルな名前(accessible name)の代用にはなりません。
タッチと状態
- コンパクトなコントロールのクリック領域は 40px 以上、モバイルの主要操作は 44px 以上である必要があります;
- ホバー効果のみをヒントとして使用しないでください;
- Disabled、Loading、Empty、Error の各状態には理解可能なフィードバックが必要です;
- 危険な操作は明確なテキストと確認フローを使用し、赤色のみには依存しないでください。
レスポンシブレイアウト
- タブレット以下の画面では、マルチカラムレイアウトをタスクの優先度に応じてシングルカラム、折りたたみ、またはドラワーに変更します;
- Header、Toolbar、テーブル、プレビューボックス、アクショングループは安定したサイズを維持します;
- 長いラベル、翻訳テキスト、ユーザーコンテンツが隣接する操作を覆わないようにします;
- デスクトップとモバイルの両方で、実際のコンテンツ、フォーカス順序、横方向のオーバーフローを検証します。
コンテンツとコントラスト
- 本文、説明文、CTA は、ライトテーマ、ダークテーマ、テーマ付き背景において可読性を維持します;
- 画像にはコンテンツに適合する代替テキストを提供します;
- 状態は色だけで表現しないでください;
- アニメーションは
prefers-reduced-motionに従い、重要なフローはアニメーションの完了に依存しないでください。