ARIA: listitem ロール

{{ariaref}}

ARIAの listitem ロールは、項目のリスト内の項目を識別するために使用できます。 これは、通常、リストコンテナを識別するために使用される list ロールとともに使用されます。

<section role="list">
  <div role="listitem">リスト項目 1</div>
  <div role="listitem">リスト項目 2</div>
  <div role="listitem">リスト項目 3</div>
</section>

説明

外側のコンテナとその内側の要素のリストで構成されるコンテンツは、それぞれ listlistitem のコンテナを使用して支援技術で識別できます。

リストとリスト項目をマークアップするためにどの要素を使用すべきかについて、鉄則はありませんが、リスト項目がリストのコンテキストで意味をなすようにするべきです。 例えば、買い物リスト、料理の手順、運転の指示。

警告: 可能な限り、適切な意味論の HTML 要素を使用して、list とその listitem<ul><ol><li>)をマークアップする必要があります。 詳しくは、ベストプラクティスを参照してください。

関連する WAI-ARIA のロール、ステート、プロパティ

list

項目のリスト。 list ロールを持つ要素には、子として listitem ロールを持つ1つ以上の要素、group ロールを持つ1つ以上の要素が必要です。 group ロールを持つ要素は、子として listitem ロールを持つ1つ以上の要素を持ちます。

group

リストにネストされたときにリスト項目に限定される関連オブジェクトのコレクションです。 ページの目次に独自の場所を持つほど重要ではありません。

キーボードインタラクション

無し

必要な JavaScript 機能

無し

 ARIA Lists — Scott O'Hara によるいくつかの有用な例と考え(英語)

ベストプラクティス

例えば、HTML を制御できないが、JavaScript を使用した後でアクセシビリティを動的に向上させる必要がある場合など、role="list"role="listitem" のみを使用する必要があります。

可能な限り、適切な意味論の HTML 要素を使用して、listlistitem<ol><ul><li>)をマークアップする必要があります。 例えば、上記の例は次のように書き直すべきです。

<ul>
  <li>リスト項目 1</li>
  <li>リスト項目 2</li>
  <li>リスト項目 3</li>
</ul>

リスト項目の順序が重要な場合は、順序付きリストを使用します。

<ol>
  <li>リスト項目 1</li>
  <li>リスト項目 2</li>
  <li>リスト項目 3</li>
</ol>

: ARIA の list ロールと listitem ロールでは、順序付きリストと順序無しリストを区別しません。

: タブ付きインターフェースとして機能する項目のリストをマークアップする場合は、代わりに tabtabpaneltablist ロールを使用するべきです。

仕様

仕様 状態
Accessible Rich Internet Applications (WAI-ARIA) 1.1
listitem の定義
勧告

スクリーンリーダーのサポート

TBD

関連情報