セマンティックロールを持つ要素にaria-roledescriptionを使用する

ARIA は提供されている任意のロールにどの属性が使用できるかということと、各属性については、使用できる箇所を明確に定義しています。各属性の詳細は各ロールおよび/または各属性についての資料を調べることで見つけられます。

aria-roledescription には二つの不合格になる条件、三つの合格になる条件、そして二つの保留になる条件があります。

aria-roledescription に不合格になる条件:

aria-roledescription は role 値を指定するべき要素に role 値がない場合、その要素に対して不合格という結果を返します。

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

aria-roledescription に合格する条件:

• aria-roledescription は明確にサポートされた role を持つ要素に対して合格という結果を返します。
• aria-roledescription は暗黙的にサポートされた role を持つ要素に対して合格という結果を返します。

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 はサポートされていない role を持つ要素に対して未定義という結果を返します。

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

特定のリファレンス: どのARIA属性がHTML要素に対して使用可能もしくは使用するべきではないかについての詳細は、 ARIA in HTML - Document conformance requirements for use of ARIA attributes in HTML をご確認ください。aria-roledescription 属性を使用するための詳細については、 ARIA in HTML - aria-roledescription (property) をご確認ください。

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

• WAI-ARIA Overview
• WAI-ARIA 1.1
• WAI-ARIA Authoring Practices