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 上檢視此頁面 • 報告此內容的潛在問題