Element: ariaRelevant-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
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