ARIA: listitem ロール

ARIA のリスト項目 (listitem) ロールは、項目のリスト内の項目を識別するために使用できます。これは、通常、リストコンテナーを識別するために使用するリスト (list) ロールと組み合わせて使用します。

html

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

説明

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

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

警告: 可能な限り、適切な意味論の HTML 要素を使用して、リストとそのリスト項目 (<ul> や <ol> と <li>) をマークアップするべきです。詳しい例は、ベストプラクティスを参照してください。

無し

無し

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

role="list" と role="listitem" は必要な場合のみ使用してください。例えば、HTML を制御できなくても、JavaScript で事後に動的にアクセシビリティを向上させることができる場合です。

可能な限り、適切な意味論の HTML 要素を使用して、リストとリスト項目 (<ol> や <ul> と <li>) をマークアップするべきです。例えば、上記の例は次のように書き直すべきです。

html

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

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

html

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

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

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

Specification
Accessible Rich Internet Applications (WAI-ARIA) # listitem

TBD

This page was last modified on ⁨2025年4月12日⁩ by MDN contributors.