必须从1开始计数且与aria-setsize成对使用，满足1≤aria-posinset≤aria-setsize；用于自定义列表、虚拟滚动、树形结构、分页及动态筛选等场景，需手动精确设置以保障屏幕阅读器正确播报位置上下文。

必须从 1 开始算，不能套用 JS 数组索引；且必须和 aria-setsize 成对出现、满足 1 ≤ aria-posinset ≤ aria-setsize，否则屏幕阅读器会丢掉位置上下文。

什么时候必须手动设 aria-posinset

原生 <ol></ol> 自带序号语义，但绝大多数自定义列表不会自动提供——只要用了 role="listitem"、role="option" 或 role="treeitem"，且父容器没用语义化 <ol></ol> 或 role="list"，就得手动标。

• React/Vue 手写虚拟滚动列表（比如传入的 itemData 是过滤后数组）
• ng-select、Ant Design Select 等下拉组件中渲染的选项项
• 树形结构里展开后的子节点（此时 aria-setsize 是同级兄弟数，不是整棵树节点总数）
• 分页场景：第 2 页第一项不是 aria-posinset="1"，而是按全局顺序，比如 "26"

aria-posinset 的取值逻辑别踩坑

它不是“当前渲染第几个”，而是“在当前可见/可用集合中排第几”。常见错误是拿原始数据索引直接 +1，或忽略筛选、分页、展开状态的影响。

html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载

• JS 数组索引为 0 → 必须 +1，例如 items[5] 对应 aria-posinset="6"
• 搜索后只剩 3 个可选项 → aria-setsize="3"，对应项的 aria-posinset 只能是 "1"、"2" 或 "3"
• 树节点异步加载，初始无子节点 → aria-setsize="0"，等加载完成再 patch 为真实数量
• 已选项置顶的多选下拉中，新渲染的待选项序号要跳过已选项，重新连续编号

为什么设了还是没读出来

两个属性只在有明确集合角色的上下文中生效：role="listbox"、role="tree"、role="grid" 是必要前提。单独给 div 加 aria-posinset 没用。

• 父容器缺 role，比如只写了 <ul role="none"></ul> → 屏幕阅读器无视所有子项的 aria-posinset
• 子元素用了 role="option"，但父容器是 <div> 且没设 <code>role="listbox" → 语义链断裂
• 动态更新后没触发重绘或未调用 aria-activedescendant 同步焦点 → 当前项位置信息不被 AT 主动播报
• NVDA/JAWS 在某些旧版浏览器中对 aria-setsize 为 0 的处理不稳定，建议避免设为 0，可暂设为 "1" 并配合 aria-hidden="true"

最常被忽略的是：它从来不是孤立存在的属性，而是一条语义链里的齿轮——role 定义容器类型，aria-setsize 告诉总数，aria-posinset 告诉当前位置，三者缺一不可，且必须实时同步。任何一环脱节，用户听到的就只是“一项”，而不是“第 7 项，共 12 项”。