ARIA: aria-posinset 屬性

描述

aria-posinset 屬性是 "position in set"（集合中的位置）的縮寫，它定義了當只有部分列表項或樹項存在於 DOM 中時，該元素在整個列表項或樹項集合中的位置。

如果列表中的所有項都存在於 DOM 中，瀏覽器可以計算出總數和每個項的位置，此時 aria-posinset 是不必要的。當集合只有一部分存在於 DOM 中時，應包含 aria-posinset 以提供有關元素在集合中位置的資訊，並配合 aria-setsize 來告知使用者完整集合中有多少項。

以下示例顯示了一個列表框，其中包含化學元素週期表 118 個元素中的 4 個選項。

html

<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 且小於或等於集合大小（當已知大小時）的整數。

注意： 使用 aria-posinset 時，還必須提供 aria-setsize 的值，它表示整個集合的大小。如果整個集合的大小未知，請將 aria-setsize 設定為 "-1"。

對於 menuitem、menuitemcheckbox 或 menuitemradio，aria-posinset 的值應相對於選單中專案的總數設定，不包括任何分隔符。

在 feed 中，每個 <article> 元素都設定了 aria-posinset，其值代表其在 feed 中的位置，同時 aria-setsize 的值設定為已載入的文章數或 feed 中的總文章數，具體取決於哪個值對使用者最有幫助。