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.
Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es 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".
<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