ElementInternals：ariaCurrent 属性

Baseline 2023

新推出

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

ElementInternals 接口的 ariaCurrent 属性反映了 aria-current 属性的值，该属性指示代表容器或一组相关元素中当前项的元素。

注意：在 ElementInternals 上设置 ARIA 属性允许为自定义元素定义默认语义。这些默认语义可能会被作者定义的属性覆盖，但可以确保在作者删除或根本未添加这些属性时，默认语义仍然保留。有关更多信息，请参阅 Accessibility Object Model explainer。

值

一个字符串，其值可能为以下之一：

"page": 表示页面集合中的当前页面。
"step": 表示过程中的当前步骤。
"location": 表示当前位置，例如面包屑导航层级中的当前页面。
"date": 表示日期集合中的当前日期。
"time": 表示时间集合中的当前时间。
"true": 表示集合中的当前项。
"false": 不表示集合中的当前项。

示例

在此示例中，ariaCurrent 的值设置为 "page"。

class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaCurrent = "page";
  }
  // …
}

规范

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

浏览器兼容性

另见

使用 aria-current 属性

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年4月25日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的潜在问题