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 des ElementInternals-Interfaces spiegelt den Wert des aria-autocomplete-Attributs wider. Dieses gibt an, ob die Eingabe von Text die Anzeige einer oder mehrerer Vorhersagen des vom Benutzer beabsichtigten Wertes für ein Kombinationsfeld, Suchfeld oder Textfeld auslösen kann und legt fest, wie Vorhersagen präsentiert würden, falls sie gemacht werden.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantik für ein benutzerdefiniertes Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standardsemantik erhalten bleibt, falls der Autor diese Attribute löscht oder überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model-Erklärungsdokument.

Wert

Ein String mit einem der folgenden Werte:

"inline"

Wenn ein Benutzer eine Eingabe macht, kann Text, der einen möglichen Abschluss der bereitgestellten Eingabe vorschlägt, dynamisch nach dem Caret eingefügt werden.

"list"

Wenn ein Benutzer eine Eingabe macht, kann ein Element angezeigt werden, das eine Sammlung von Werten enthält, die die bereitgestellte 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 bereitgestellte Eingabe vervollständigen könnten. Wenn angezeigt, wird ein Wert in der Sammlung automatisch ausgewählt, und der Text, der erforderlich ist, um den automatisch ausgewählten Wert zu vervollständigen, erscheint nach dem Caret in der Eingabe.

"none"

Wenn ein Benutzer eine Eingabe macht, wird keine automatische Vorschlagsanzeige angezeigt, die versucht vorherzusagen, wie der Benutzer die Eingabe abschließen möchte.

Beispiele

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

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaAutoComplete = "inline";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität