此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaColIndexText 属性

基线 2025
最近可用

自 2025年12月 起,此特性已在最新浏览器中得到支持。但在较旧的设备或浏览器中可能无法运行。

Element 接口的 ariaColIndexText 属性反映了 aria-colindextext 属性的值,该属性定义了 aria-colindex 的可读文本替代。

字符串。

示例

在此示例中,aria-colindextext 属性设置在 ID 为 role-heading 的元素上,值为“ARIA 角色列”。使用 ariaColIndexText 我们将值更新为字符串“新列名”。

html
<table
  id="semantic-table"
  role="table"
  aria-label="语义元素"
  aria-describedby="semantic_elements_table_desc"
  aria-rowcount="100">
  <caption id="semantic_elements_table_desc">
    用于替代 ARIA 角色的语义元素
  </caption>
  <thead role="rowgroup">
    <tr role="row">
      <th
        role="columnheader"
        id="role-heading"
        aria-sort="none"
        aria-rowindex="1"
        aria-colindex="1"
        aria-colindextext="ARIA 角色列">
        ARIA 角色
      </th>
      <th
        role="columnheader"
        id="element-heading"
        aria-sort="none"
        aria-rowindex="1">
        语义元素
      </th>
    </tr>
  </thead>
  <tbody role="rowgroup">
    <tr role="row">
      <td role="cell" aria-rowindex="11">header</td>
      <td role="cell" aria-rowindex="11">h1</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="16">header</td>
      <td role="cell" aria-rowindex="16">h6</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="18">rowgroup</td>
      <td role="cell" aria-rowindex="18">thead</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="24">term</td>
      <td role="cell" aria-rowindex="24">dt</td>
    </tr>
  </tbody>
</table>
js
let el = document.getElementById("role-heading");
console.log(el.ariaColIndexText); // "ARIA 角色"
el.ariaColIndexText = "新列名";
console.log(el.ariaColIndexText); // "新列名"

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariacolindextext

浏览器兼容性

参见