Element: ariaCurrent-Eigenschaft

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.

Die ariaCurrent-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-current-Attributs wider, welches das Element angibt, das das aktuelle Element innerhalb eines Containers oder einer Gruppe verwandter Elemente darstellt.

Wert

Ein String mit einem der folgenden Werte:

"page"

Stellt die aktuelle Seite innerhalb eines Satzes von Seiten dar.

"step"

Stellt den aktuellen Schritt innerhalb eines Prozesses dar.

"location"

Stellt den aktuellen Standort dar, zum Beispiel die aktuelle Seite in einer Breadcrumbs-Hierarchie.

"date"

Stellt das aktuelle Datum innerhalb einer Sammlung von Daten dar.

"time"

Stellt die aktuelle Uhrzeit innerhalb eines Satzes von Zeiten dar.

"true"

Stellt das aktuelle Element innerhalb einer Menge dar.

"false"

Stellt das aktuelle Element innerhalb einer Menge nicht dar.

Beispiele

In diesem Beispiel wird ein Satz von Links zur Navigation auf der Website verwendet. Das aria-current-Attribut gibt die aktuelle Seite an. Der Wert page wird in die Ausgabe des Screenreaders eingebaut. Mit ariaCurrent können wir diesen Wert aktualisieren.

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"

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch