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-Attributes wider, welches angibt, welche Benachrichtigungen der Benutzeragent auslösen wird, wenn der Barrierefreiheitsbaum innerhalb einer Live-Region modifiziert wird. Dies wird verwendet, um zu beschreiben, welche Änderungen in einer aria-live-Region relevant sind und angekündigt werden sollten.
Hinweis:
Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standard-Semantiken für ein benutzerdefiniertes Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standard-Semantiken beibehalten werden, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Explainer.
Wert
Ein String, der einen oder mehrere der folgenden, durch Leerzeichen getrennte Werte enthält:
- "additions"
-
Hinzufügungen von Elementknoten innerhalb der Live-Region sollten als relevant angesehen werden.
- "removals"
-
Löschungen von Knoten in der Live-Region sollten als relevant angesehen werden.
- "text"
-
Änderungen am Textinhalt bestehender Knoten sollten als relevant angesehen werden.
- "all"
-
Entspricht
"additions removals text".
Beispiele
In diesem Beispiel wird der Wert von ariaRelevant auf "all" gesetzt.
class CustomEl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaRelevant = "all";
}
// …
}