Element: ariaCurrent 属性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以来,此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

Element 接口的 ariaCurrent 属性反映了 aria-current 属性的值,该属性指示了代表容器或相关元素集合中当前项的元素。

一个字符串,其值可能为以下之一:

"page"

表示页面集合中的当前页面。

"step"

表示流程中的当前步骤。

"location"

表示当前位置,例如面包屑导航层级中的当前页面。

"date"

表示日期集合中的当前日期。

"time"

表示时间集合中的当前时间。

"true"

表示集合中的当前项。

"false"

不表示集合中的当前项。

示例

在此示例中,使用了一组链接用于站点导航。aria-current 属性指示了当前页面。page 值会被合并到屏幕阅读器的播报中。使用 ariaCurrent 我们可以更新该值。

html
<nav>
  <ul>
    <li><a id="link-home" href="/" aria-current="page">Home</a></li>
    <li><a href="/">About</a></li>
    <li><a href="/">Contact</a></li>
  </ul>
</nav>
js
let el = document.getElementById("link-home");
console.log(el.ariaCurrent); // "page"
el.ariaCurrent = "tab";
console.log(el.ariaCurrent); // "tab"

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# dom-ariamixin-ariacurrent

浏览器兼容性

另见