ElementInternals: ariaInvalid-Eigenschaft
Baseline 2023Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Die ariaInvalid-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-invalid-Attributs wider. Relevant für die Rollen application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox und tree, zeigt es der Zugänglichkeits-API an, ob der eingegebene Wert nicht dem erwarteten Format der Anwendung entspricht.
Hinweis:
Das Setzen von ARIA-Attributen auf ElementInternals ermöglicht es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, aber sie stellen sicher, dass Standardsemantiken erhalten bleiben, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Explainer.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist ungültig.
"false"(Standard)-
Das Element befindet sich nicht in einem ungültigen Zustand.
"grammar"-
Das Element befindet sich in einem ungültigen Zustand, weil ein grammatikalischer Fehler erkannt wurde.
"spelling"-
Das Element befindet sich in einem ungültigen Zustand, weil ein Rechtschreibfehler erkannt wurde.
Beispiele
In diesem Beispiel definieren und erstellen wir ein <custom-text>-Element und rufen dann den Wert von ariaInvalid vom ersten <custom-text>-Element im Dokument ab.
class CustomControl extends HTMLElement {
constructor() {
super();
this._internals = this.attachInternals();
this._internals.ariaInvalid = "false";
}
// …
}
window.customElements.define("custom-text", CustomControl);
const element = document.querySelector("custom-text");
console.log(element._internals.ariaInvalid);
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariainvalid |