aria-colindextext

aria-colindextext 属性定义了数字 aria-colindex 的人类可读文本替代项。

描述

当您有一个非常大的表格或当您有意仅显示表格的一部分时，并非所有列都可能存在于 DOM 中。发生这种情况时，我们使用 aria-colcount 和整数来定义如果所有列都存在表格（或网格）将有多少列，并在每一列上添加 aria-colindex 属性以提供有关该更大表格中列索引的信息。

在以下 HTML 代码段中，我们的表格有 8 列，但我们只显示了 4 列。“城市”列是我们更大表格的第五列，如 aria-colindex="5" 所定义。

html
<table aria-colcount="8">
  <thead>
    <tr>
      <th aria-colindex="1" scope="col">First name</th>
      <th aria-colindex="2" scope="col">Last name</th>
      <th aria-colindex="5" scope="col">City</th>
      <th aria-colindex="7" scope="col">Zip</th>
    </tr>
  </thead>
  …
</table>

此表格并不复杂。如果这是一个包含 100 多列的电子表格或没有列标题的网格（例如棋盘），则 aria-colindex 的提供或计算值可能没有意义或可能不反映显示的索引。在这种情况下，可以包含 aria-colindextext。该值是一个字符串，它是数字 aria-colindex 的人类可读文本替代项。

html
<table aria-colcount="128">
  <thead>
    <tr>
      <th aria-colindex="1" aria-colindextext="NYSE stock symbol" scope="col">
        NYSE
      </th>
      <th
        aria-colindex="110"
        aria-colindextext="Value at start of 2021"
        scope="col">
        01/21
      </th>
      <th
        aria-colindex="122"
        aria-colindextext="Value at start of 2022"
        scope="col">
        01/22
      </th>
      <th aria-colindex="124" scope="col">Recommendation</th>
    </tr>
  </thead>
  …
</table>

在上面的示例中，表格有 128 列，但仅显示了 4 列。aria-colindextext 用于三列以提供人类可读的文本替代项。通过包含 aria-colindextext="2021 年初的值"，辅助技术可以宣布“2021 年初的值”而不是“第 110 列”。

仅当 aria-colindex 的提供或计算值没有意义或不反映显示的索引时，才使用 aria-colindextext。每当您包含 aria-colindextext 时，也请保留 aria-colindex，因为某些辅助技术依赖于数字列索引以跟踪用户的位置并提供替代表格导航。

注意：虽然当所有存在的列都是连续的时，可以将 aria-colindex 添加到行中，因为可以推导出顺序值，但 aria-colindextext **不是** row 的受支持属性。

请参阅相关的 aria-rowindextext。

值

<字符串>

数字 aria-colindex 的人类可读文本替代项

关联接口

Element.ariaColIndexText

ariaColIndexText 属性（Element 接口的一部分）反映了 aria-colindextext 属性的值。

ElementInternals.ariaColIndexText

ariaColIndexText 属性（ElementInternals 接口的一部分）反映了 aria-colindextext 属性的值。

关联角色

用于的角色

继承到角色

规范

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

另请参阅