aria-posinset

aria-posinset 属性定义了元素在当前一组列表项或树项中的编号或位置，当并非所有项目都存在于 DOM 中时。

描述

aria-posinset 属性的缩写是“集合中的位置”，它定义了元素在整个列表项或树项集合中的位置，当只有一部分项目存在于 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 设置为表示其在提要中的位置的值，并且 aria-setsize 设置为已加载的文章数量或提要中的总数，具体取决于哪个值对用户更有帮助。

值

<整数>: 大于或等于 1 且小于或等于 aria-setsize 值的整数。

关联接口

Element.ariaPosInSet: ariaPosInSet 属性（Element 接口的一部分）反映 aria-posinset 属性的值。
ElementInternals.ariaPosInSet: ariaPosInSet 属性（ElementInternals 接口的一部分）反映 aria-posinset 属性的值。

关联角色

用于角色

继承到角色

规范

规范
可访问的富互联网应用程序 (WAI-ARIA) # aria-posinset

另请参阅

aria-setsize