元素:ariaCurrent 属性

基线 2023

新可用

2023 年 10 月起,此功能在最新的设备和浏览器版本中均有效。此功能可能在较旧的设备或浏览器中无法正常工作。

ariaCurrentElement 接口的属性,它反映了 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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅