ElementInternals: ariaRelevant-Eigenschaft

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 ElementInternals-Interfaces spiegelt den Wert des aria-relevant-Attributs wider, welches angibt, welche Benachrichtigungen der Benutzeragent auslöst, wenn der Accessibility-Baum innerhalb einer Live-Region geändert wird. Dies wird verwendet, um zu beschreiben, welche Änderungen in einer aria-live-Region relevant sind und angekündigt werden sollten.

Hinweis: Das Festlegen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken bei einem benutzerdefinierten Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, aber es wird sichergestellt, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie in der Accessibility Object Model Beschreibung.

Wert

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

"additions"

Hinzufügungen von Element-Knoten innerhalb der Live-Region sollten als relevant betrachtet werden.

"removals"

Das Löschen von Knoten aus der Live-Region sollte als relevant betrachtet werden.

"text"

Änderungen am Textinhalt bestehender Knoten sollten als relevant betrachtet werden.

"all"

Entspricht "additions removals text".

Beispiele

In diesem Beispiel wird der Wert von ariaRelevant auf "all" gesetzt.

js
this.internals_.ariaRelevant = "all";

Browser-Kompatibilität

BCD tables only load in the browser