Element: ariaCurrent-Eigenschaft
Baseline 2023Newly 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, das das Element kennzeichnet, das das aktuelle Element innerhalb eines Containers oder einer Reihe verwandter Elemente darstellt.
Wert
Ein String mit einem der folgenden Werte:
"page"
-
Stellt die aktuelle Seite innerhalb einer Reihe von Seiten dar.
"step"
-
Stellt den aktuellen Schritt innerhalb eines Prozesses dar.
"location"
-
Stellt den aktuellen Ort dar, beispielsweise die aktuelle Seite in einer Breadcrumbs-Hierarchie.
"date"
-
Stellt das aktuelle Datum innerhalb einer Sammlung von Daten dar.
"time"
-
Stellt die aktuelle Zeit innerhalb einer Reihe von Zeiten dar.
"true"
-
Stellt das aktuelle Element innerhalb einer Reihe dar.
"false"
-
Stellt nicht das aktuelle Element innerhalb einer Reihe dar.
Beispiele
In diesem Beispiel wird eine Reihe von Links für die Navigation auf der Website verwendet. Das aria-current
-Attribut kennzeichnet die aktuelle Seite. Der Wert page
wird in die Screenreader-Ausgabe aufgenommen. Mit ariaCurrent
können wir diesen Wert aktualisieren.
<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>
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 |