aria-roledescriptionはセマンティックロールを持つ要素になければなりません

ARIAは、特定のロールに対してどの属性が許可されるか、また各属性がどこで使用される可能性があるかを明示的に定義します。各属性の詳細情報については、各ロールおよび/または各属性のドキュメントを参照してください。

aria-roledescription ルールには、失敗条件が2つ、成功条件が3つ、不完全条件が2つ含まれています。

aria-roledescriptionの失敗条件:

aria-roledescription は、ロール値を指定する必要がある要素でロール値を持たない要素に対してfalseを返します。

• <p aria-roledescription="my paragraph" id="fail1">paragraph</p>
• <div aria-roledescription="my div" id="fail2">div</div>

aria-roledescription合格条件:

• aria-roledescription は、 明示的に サポートされているロールを持つ要素に対して true を返します。
• aria-roledescription は、 暗黙的に サポートされているロールを持つ要素に対して true を返します。

1. <img aria-roledescription="my img" src="foo.png" id="pass1" />
2. <button aria-roledescription="my button" id="pass2">button</button>
3. <div role="combobox" aria-roledescription="my combobox" id="pass3"></div>

aria-roledescription不完全な状態:

aria-roledescription は、サポートされていないロールを持つ要素に対して undefined を返します。

1. <h1 aria-roledescription="my heading" id="incomplete1">heading</h1>
2. <div role="rowgroup" aria-roledescription="my row" id="incomplete2"></div>

具体的な参照: HTML要素で使用できるARIA属性と使用すべきでないARIA属性の詳細については、 HTMLでのARIA - HTMLでのARIA属性の使用に関するドキュメント適合要件を参照してください。 .aria-roledescription 属性の使用に関する詳細については、 HTMLのARIA - aria-roledescription (プロパティ) を参照してください。 .

一般的なリファレンス: ARIAの一般的な情報については、次の外部リソースを参照してください。ARIAは主にWeb開発者やプログラマーによって使用され、ARIAを効果的に実装するには通常JavaScriptのスキルが必要です。プログラミングロジックの複雑さと、ARIAの有効な組み合わせを要求する仕様の微妙な差異により、ARIAの学習は長いプロセスになる可能性があります。 role aria-roledescription

• WAI-ARIAの概要
• WAI-ARIA 1.1
• WAI-ARIAオーサリングプラクティス