ElementInternals: ariaAutoComplete-Eigenschaft

Baseline 2023

Newly 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 ariaAutoComplete-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-autocomplete-Attributs wider, welches angibt, ob die Eingabe von Text die Anzeige einer oder mehrerer Vorhersagen des beabsichtigten Wertes eines Kombinationsfeldes, Suchfeldes oder Textfeldes auslösen könnte und spezifiziert, wie Vorhersagen präsentiert würden, falls sie gemacht werden.

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, stellen aber sicher, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model Explainer.

Wert

Ein String mit einem der folgenden Werte:

"inline"

Wenn ein Benutzer eine Eingabe macht, kann dynamisch Text eingefügt werden, der einen Vorschlag zur Vervollständigung der Eingabe liefert, nachdem der Kursor.

"list"

Wenn ein Benutzer eine Eingabe macht, kann ein Element angezeigt werden, das eine Sammlung von Werten enthält, die die Eingabe vervollständigen könnten.

"both"

Wenn ein Benutzer eine Eingabe macht, kann ein Element angezeigt werden, das eine Sammlung von Werten enthält, die die Eingabe vervollständigen könnten. Falls angezeigt, wird ein Wert in der Sammlung automatisch ausgewählt und der Text, der benötigt wird, um den automatisch ausgewählten Wert zu vervollständigen, erscheint nach dem Kursor in der Eingabe.

"none"

Wenn ein Benutzer eine Eingabe macht, gibt es keine Anzeige eines automatischen Vorschlags, der versucht, vorherzusagen, wie der Benutzer die Eingabe abschließen will.

Beispiele

In diesem Beispiel wird der Wert von ariaAutoComplete auf "inline" gesetzt.

js
this.internals_.ariaAutoComplete = "inline";

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaautocomplete

Browser-Kompatibilität

BCD tables only load in the browser