aria-colindex不能用于原生HTML表格的colspan合并单元格，因其会干扰屏幕阅读器对逻辑列范围的正确解析；仅在role="grid"虚拟表格中，需配合aria-colspan显式声明起始列号与跨列数。
aria-colindex 不能用于 colspan 合并的单元格
原生 HTML 表格中，colspan 是语义级跨列行为，浏览器和屏幕阅读器直接基于 <td colspan="3"> 推断该单元格横跨逻辑列 1–3；此时加 aria-colindex="1" 不仅多余，还会干扰 AT 解析——它会误以为这个单元格只属于第 1 列，而忽略其实际占据的列范围。
合并列时，aria-colindex 只适用于 role="grid" 虚拟表格
如果你用 div + role="grid" 实现表格（比如 React/Vue 自定义组件、Canvas 渲染网格），且需视觉上“合并”两列（例如 CSS grid-column: span 2），那么 aria-colindex 必须指向**起始列号**，且需配合 aria-colspan 显式声明跨度：
-
aria-colindex值必须是整数，从 1 开始，不能为 0 或负数 -
aria-colspan是必需的补充属性（ARIA 1.2+ 支持），值也必须是正整数 - 例如：一个视觉上横跨第 4 和第 5 列的单元格，应写成
<div role="gridcell" aria-colindex="4" aria-colspan="2">合计</div> - 若省略
aria-colspan，AT 会默认当它只占 1 列，导致后续单元格列索引错位
原生 <table> 中混用 aria-colindex 会破坏可访问性
在标准 <table> 里给 <td> 或 <th> 加 aria-colindex 属于典型误用：
- 浏览器已通过 DOM 结构和
colspan自动计算逻辑列位置，额外加aria-colindex可能覆盖正确推断 - 某些旧版 JAWS/NVDA 会优先读取
aria-colindex而忽略colspan，造成“读出第 1 列”但实际显示在第 4 列的错乱 - WAVE、axe 等检测工具会报 ARIA 属性冲突警告
- 正确做法是：删掉所有
aria-colindex，确保colspan值合法（正整数）、且每行总列数一致（可用Array.from(tr.children).reduce((s, el) => s + (el.colSpan || 1), 0)验证）
虚拟表格中漏设 aria-colspan 的典型错误现象
常见表现不是“不生效”，而是 AT 在朗读时跳过整列或重复播报：
立即学习“前端免费学习笔记（深入）”；
- 用户听到：“第 4 列，合计；第 5 列，空；第 6 列，金额”——其实第 5 列本应被第 4 列的跨列覆盖
- 方向键向右移动时，焦点从第 4 列直接跳到第 6 列，中间“消失”的第 5 列无法聚焦
- 原因：AT 按
aria-colindex顺序找下一列，发现没有aria-colindex="5"的单元格，就认为该列“不存在”而非“被合并” - 修复只需一行：
aria-colspan="2"，不需要改 CSS 或 DOM 结构
aria-colindex 和 aria-colspan —— 视觉位置变了，AT 还按旧索引读，这种错位没法靠测试工具发现，只能靠真实屏幕阅读器验证。 
