ドキュメントを検索

アクセシビリティ

leve-uiがアクセシビリティに関して処理すること、および開発者が対応すること。

すべてのコンポーネントはWAI-ARIA Authoring Practices Guide(APG)に準拠しています。AvatarやFieldのようにコンポーネントに対応するAPGパターンがない場合は、ネイティブHTML要素のセマンティクスを使用します。各コンポーネントのページには、準拠するパターン、描画されるロールや属性、キーボード操作を記載したAccessibilityセクションがあります。

leve-uiが処理すること#

  • ネイティブ要素を優先。ボタンは<button type="button">、リンクは<a>、フィールドのグループは<fieldset>です。roleは、Switch.Controlのrole="switch"のように適合するネイティブ要素がない場合にのみ追加されます。
  • ロールとARIA属性。role、aria-checked、aria-expanded、aria-controls、aria-labelledbyなど、パターンに必要な属性は常に描画されます。これらはユーザーのpropsの後に記述されるため、誤って上書きされることはありません。
  • サーバーとクライアントで一致するid。パーツはQwikのuseId()によるidで接続されるため、JavaScriptが実行される前から、サーバーで描画されたHTML内の参照が正確になります。Field内では、idはField.Rootから提供されます。
  • キーボード操作。Enter、Space、Escape、矢印キー、Home、Endなど、APGパターンで定義されているすべてのキーが実装されています。
  • フォーカス管理。Tabs、Radio Group、Toggle Groupなどの複合ウィジェットはroving tabindexを使用します。タブ順序に含まれるアイテムは1つだけで、矢印キーでアイテム間をフォーカス移動します。
  • 無効状態。ネイティブ要素はdisabledを使用し、その他の要素はaria-disabled="true"を使用します。無効化されたアイテムがフォーカス可能なまま残るかどうかはAPGに従います。
  • 装飾パーツの非表示。Switch.ThumbやフォームコントロールのHiddenInputなど、それ自体に意味を持たないパーツにはaria-hidden="true"が設定されます。

開発者が提供するもの#

leve-uiはヘッドレスであるため、アクセシビリティの一部はコンテンツやスタイルに依存します。

  • アクセシブルな名前。各コントロールには、そのLabelパーツ、Field.Label、またはaria-label/aria-labelledbyで名前を付けてください。アイコンのみのボタンにはaria-labelが必要です。
  • 代替テキスト。Avatar.Imageなどの画像にはaltを渡し、装飾用アイコンにはaria-hidden="true"をマークしてください。
  • 可視フォーカス。leve-uiはCSSを提供しないため、フォーカスのアウトラインを追加することも削除することもありません。:focus-visibleなどを使用してスタイルでフォーカスを可視状態に保つようにしてください(Stylingを参照)。
  • 色とコントラスト。テキスト、コントロール、状態に十分なコントラストのある色を選択し、色だけで状態を伝えないようにしてください。
  • 状態に一致するコンテンツ。状態を説明するためにラベルを変更しないでください(例:スイッチの「On」/「Off」)。状態はaria-checkedなどの属性によって伝達されます。

テスト方法#

  • 単体テストでは、すべてのパーツが必要なロール、aria-*属性、id参照を描画することを確認します。
  • E2EテストはPlaywrightを使用して実際のブラウザで実行されます。APGの各キーボード操作に個別のテストがあり、フォーカスの移動と復帰もテストされます。要素は支援技術が認識するのと同じように、ロールとアクセシブルな名前で検索されます。

テストはリポジトリにあります。アクセシビリティに関する問題を見つけた場合は、イシューをオープンしてください。