Element: ariaRelevant-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die ariaRelevant-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-relevant-Attributs wider, das angibt, welche Benachrichtigungen der Benutzeragent auslösen wird, wenn der Zugänglichkeitsbaum innerhalb eines Live-Bereichs geändert wird. Dies wird verwendet, um zu beschreiben, welche Änderungen in einem aria-live-Bereich relevant sind und angekündigt werden sollen.
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 angesehen werden.
"removals"-
Löschungen von Knoten aus dem Live-Bereich sollten als relevant angesehen werden.
"text"-
Änderungen des Textinhalts bestehender Knoten sollten als relevant angesehen 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