Element: ariaRelevant-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.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.

Die ariaRelevant-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-relevant-Attributs wider. Dieses Attribut gibt an, welche Benachrichtigungen der Benutzeragent auslösen wird, wenn der Barrierefreiheitsbaum innerhalb eines Live-Bereichs verändert wird. Es wird verwendet, um zu beschreiben, welche Änderungen in einem aria-live-Bereich relevant sind und angesagt werden sollten.

Wert

Ein String, der einen oder mehrere der folgenden Werte enthält, durch Leerzeichen getrennt:

"additions": Hinzufügungen von Elementknoten innerhalb des Live-Bereichs sollten als relevant betrachtet werden.
"removals": Das Entfernen von Knoten aus dem Live-Bereich sollte als relevant betrachtet werden.
"text": Änderungen des Textinhalts bestehender Knoten sollten als relevant betrachtet werden.
"all": Entspricht "additions removals text".

Beispiele

In diesem Beispiel wird das aria-relevant-Attribut auf dem Element mit der ID text auf "all" gesetzt. Mit ariaRelevant aktualisieren wir den Wert auf "text".

html

<div
  id="clock"
  role="timer"
  aria-live="polite"
  aria-atomic="true"
  aria-relevant="all"></div>

let el = document.getElementById("clock");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // text

Browser-Kompatibilität

BCD tables only load in the browser