ElementInternals: 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 ElementInternals-Interfaces spiegelt den Wert des aria-current-Attributs wider, welches das Element kennzeichnet, das das aktuelle Element innerhalb eines Containers oder einer Menge verwandter Elemente repräsentiert.

Hinweis: Das Setzen von ARIA-Attributen auf ElementInternals ermöglicht es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standardsemantiken erhalten bleiben, falls der Autor diese Attribute löscht oder gar nicht erst hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Erklärungsdokument.

Wert

Ein String mit einem der folgenden Werte:

"page"

Repräsentiert die aktuelle Seite innerhalb eines Satzes von Seiten.

"step"

Repräsentiert den aktuellen Schritt innerhalb eines Prozesses.

"location"

Repräsentiert den aktuellen Standort, zum Beispiel die aktuelle Seite in einer Brotkrumen-Hierarchie.

"date"

Repräsentiert das aktuelle Datum innerhalb einer Sammlung von Daten.

"time"

Repräsentiert die aktuelle Zeit innerhalb eines Satzes von Zeiten.

"true"

Repräsentiert das aktuelle Element innerhalb einer Menge.

"false"

Repräsentiert nicht das aktuelle Element innerhalb einer Menge.

Beispiele

In diesem Beispiel wird der Wert von ariaCurrent auf "page" gesetzt.

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaCurrent = "page";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität

Siehe auch