アクセシビリティ
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の各キーボード操作に個別のテストがあり、フォーカスの移動と復帰もテストされます。要素は支援技術が認識するのと同じように、ロールとアクセシブルな名前で検索されます。