使用されるARIAロールは有効な値に準拠している必要があります
ルールID:
aria-roles
ルールセット:
axe-core 4.10
ユーザーへの影響:
ガイドライン:
WCAG 2.1 (A), WCAG 2.0 (A), WCAG 2.2 (A), EN 301 549
修正方法
role=""
ARIAに割り当てられたすべての値が有効なロールに対応していることを確認してください。
タイプ別に利用可能なロールは次のとおりです。
- ドキュメント ブロック: アプリケーション、記事、引用ブロック、キャプション、ドキュメント、フィード、グループ、見出し、リスト、リスト項目、メモ、段落、セパレーター (フォーカスできない場合)、ツールバー。
- ドキュメント コンテンツ : コード、定義、削除、強調、図、画像、挿入、マーク、数式、メーター、ストロング、下付き文字、上付き文字、用語、時間、ツールヒント
- ランドマーク: バナー、補足、コンテンツ情報、フォーム、メイン、ナビゲーション、リージョン、検索。
- ライブ領域: アラート、ログ、マーキー、ステータス、タイマー。
- 表示: なし、一般、プレゼンテーション(要素のネイティブな役割をキャンセルする)
- 表: セル、列ヘッダー、行、行グループ、行ヘッダー、表。
- ウィジェット: ボタン、チェックボックス、グリッドセル、リンク、メニュー項目、メニュー項目チェックボックス、メニュー項目ラジオ、オプション、プログレスバー、ラジオ、スクロールバー、検索ボックス、セパレーター (フォーカス可能な場合)、スライダー、スピンボタン、スイッチ、タブ、タブパネル、テキストボックス、ツリー項目。
- ウィジェット (複合): コンボボックス、グリッド、リストボックス、メニュー、メニューバー、ラジオグループ、タブリスト、ツリー、ツリーグリッド。
- ウィンドウの役割: alertdialog、dialog。
なぜ重要なのか
無効なARIAロール値が割り当てられた要素は、開発者の意図どおりに支援技術によって解釈されません。
スクリーン リーダーやその他の支援技術がWebページ上の各要素の役割を認識していない場合、要素をインテリジェントに操作できず、その役割をユーザーに伝えることもできません。ロール値が無効な場合、要素の機能、プロパティ、およびユーザーへの情報伝達の機能、プロパティ、方法は、支援技術を介して伝達できません。
ルールの説明
ARIAロール値に割り当てられた値は有効である必要があります。ロール値は正しく綴られ、既存のARIA role
値に対応している必要があり、要素の目的を正しく公開するために抽象的なロールであってはなりません。
仕組みについて (簡単に言うと)
WAI-ARIAロール属性を含むすべての要素をチェックし、ロール値が有効であることを確認します。