Element: ariaCurrent プロパティ

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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"

仕様書

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariacurrent

ブラウザーの互換性

BCD tables only load in the browser

関連情報