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 中的总文章数，具体取决于哪个值对用户最有帮助。