aria-colindex不能用于原生<td>或<th>元素，仅在role="grid"或role="treegrid"的自定义网格中有效；必须配合aria-colcount、aria-rowcount及每个gridcell的aria-colindex（1-based）使用，且需严格对应完整逻辑列位置。
aria-colindex 不能直接用于 <td> 或 <th> 元素
这是最常踩的坑：WAI-ARIA 规范明确禁止在 <td>、<th> 上设置 aria-colindex。它只被允许出现在 <table> 元素上，且仅当表格使用了 role="grid" 或 role="treegrid" 时才有效——也就是说，原生语义的 <table> 不支持 aria-colindex。
如果你只是给普通 HTML 表格加 aria-colindex="5"，屏幕阅读器会忽略它，甚至可能报错或降级处理。
- 普通表格（
<table>）靠 DOM 顺序和<colgroup>/<col>隐式定义列逻辑结构，无需也不该用aria-colindex - 如果需要显式控制列索引（比如虚拟滚动、列冻结、懒加载列），必须切换为
role="grid"模式，并手动管理所有 ARIA 属性 -
aria-colindex是 1-based 整数，表示该单元格在完整逻辑表格中的列号，不是视觉位置（例如隐藏列仍要计入）
用 role="grid" + aria-colindex 的最小可行结构
想让 aria-colindex 生效，必须放弃原生 <table> 语义，改用 div 模拟 grid，并严格遵循 ARIA Authoring Practices。
<div role="grid" aria-rowcount="1000" aria-colcount="50">
<div role="row">
<div role="gridcell" aria-colindex="1">姓名</div>
<div role="gridcell" aria-colindex="2">邮箱</div>
<div role="gridcell" aria-colindex="47">最后登录时间</div>
</div>
<div role="row">
<div role="gridcell" aria-colindex="1">张三</div>
<div role="gridcell" aria-colindex="2">zhang@example.com</div>
<div role="gridcell" aria-colindex="47">2024-06-10</div>
</div>
</div>
-
aria-colcount必须设为完整逻辑列数（哪怕只渲染前 5 列） - 每行中每个
gridcell都得有aria-colindex，跳过中间列（如从 2 直接到 47）是合法的，但必须准确反映逻辑位置 - 缺失的列（如未渲染的中间列）不能留空 —— 要么不渲染，要么用
aria-hidden="true"+ 占位，否则行列对齐会错乱
为什么不用 <colgroup> 就容易出问题
原生表格中，<colgroup> 和 <col> 是唯一能提前声明列逻辑结构的机制。如果省略它们，又动态增删列或使用 CSS display: none 隐藏列，屏幕阅读器可能按 DOM 顺序读取，把视觉上第 3 列当成逻辑第 1 列。
立即学习“前端免费学习笔记（深入）”；
-
<colgroup>中的<col>元素可带span属性，但无法表达“第 47 列”这种稀疏索引；它只适合连续列定义 - 若列顺序与 DOM 不一致（比如用 CSS
order重排），<colgroup>仍按 HTML 顺序生效，此时必须用role="grid"替代 - 浏览器对
<col>的 ARIA 支持较弱，不要指望aria-colindex能作用于<col>
性能与兼容性现实约束
aria-colindex 在 role="grid" 下虽可用，但实际落地时限制极多：
- 主流屏幕阅读器（NVDA、VoiceOver）对超大
aria-colcount（如 >100）响应迟缓，滚动时可能卡顿或跳读 - 没有
aria-rowindex对应物，必须同时维护aria-rowindex和aria-colindex，否则行列定位失效 - React/Vue 等框架中，key 和 ARIA 索引不一致会导致焦点丢失 ——
aria-colindex值必须随数据真实逻辑位置更新，不能按渲染序号硬编码 - 移动端 VoiceOver 对 grid 的列导航支持不稳定，部分机型仅支持左右滑动，不识别
aria-colindex
真正需要列逻辑索引的场景，往往已超出纯 HTML 表格能力边界；这时候更可靠的方案是分页、列筛选，或用专门的可访问表格库（如 AG Grid 的 ARIA 模式），而不是手写 aria-colindex。
