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

瀏覽器相容性

另見