aria-posinset

「position in set」（セット内の位置）の略である aria-posinset 属性は、項目のサブセットのみが DOM 内に存在する場合に、リスト項目またはツリー項目のセット全体内での要素の位置を定義します。

リスト内の全ての項目が DOM に存在する場合、ブラウザーは各項目の合計と位置を計算できるため、aria-posinset は不要です。セットの一部のみが DOM に存在する場合は aria-posinset を含めて、セット内の要素の位置に関する情報を提供するとともに、aria-setsize を使用して完全なセットに含まれる項目の数をユーザーに通知します。

次の例は、化学元素周期表の 118 個の元素のうち 4 つの元素オプションを含むリストボックスを示しています。

<h2 id="periodic-table">Periodic table of chemical elements</h2>
<ul role="listbox" aria-labelledby="periodic-table">
  <li role="option" aria-setsize="118" aria-posinset="1">Hydrogen</li>
  <li role="option" aria-setsize="118" aria-posinset="3">Lithium</li>
  <li role="option" aria-setsize="118" aria-posinset="11">Sodium</li>
  <li role="option" aria-setsize="118" aria-posinset="19">Potassium</li>
</ul>

aria-posinset のそれぞれの値は、1 以上の整数であり、セットのサイズが分かっている場合はセットのサイズ以下の整数です。

menuitem、menuitemcheckbox、または menuitemradio の場合、区切り線を除いたメニュー内の項目の合計数に対して aria-posinset の値を設定します。

feed では、各 <article> 要素の aria-posinset にはフィード内の位置を表す値が設定され、aria-setsize には、読み込まれた記事の数またはフィード内の合計数のいずれか、ユーザーにとって最も役立つ方が設定されます。

<integer>

1 以上で aria-setsize の値以下の整数。

Element.ariaPosInSet

Element インターフェイスの一部である ariaPosInSet プロパティは、aria-posinset 属性の値を反映します。

ElementInternals.ariaPosInSet

ElementInternals インターフェイスの一部である ariaPosInSet プロパティは、aria-posinset 属性の値を反映します。

使用するロール:

• article
• associationlistitemkey
• associationlistitemvalue
• comment
• listitem
• menuitem
• option
• radio
• row
• tab

継承先のロール:

• comment
• menuitemcheckbox
• menuitemradio
• treeitem

• aria-setsize