Element: 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 Element-Schnittstelle spiegelt den Wert des aria-autocomplete-Attributs wider, das angibt, ob das Eingeben von Text die Anzeige von einer oder mehreren Vorhersagen des vom Benutzer beabsichtigten Werts für ein Kombinationsfeld, Suchfeld oder Textfeld auslösen könnte und wie diese Vorhersagen präsentiert würden, falls sie gemacht wurden.

Wert

Ein String mit einem der folgenden Werte:

"inline"

Wenn ein Benutzer eine Eingabe macht, kann ein Text, der eine Möglichkeit zur Vervollständigung der eingegebenen Daten vorschlägt, dynamisch nach dem Cursor eingefügt werden.

"list"

Wenn ein Benutzer eine Eingabe macht, kann ein Element angezeigt werden, das eine Sammlung von Werten enthält, die die eingegebene Information 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 eingegebene Information 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 Cursor 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 möchte.

Beispiele

In diesem Beispiel wird das aria-autocomplete-Attribut des Elements mit der ID animal auf "inline" gesetzt. Mit ariaAutoComplete aktualisieren wir den Wert auf "list", was der erwartete Wert für ein Kombinationsfeld ist, das ein listbox-Popup aufruft.

html
<div class="animals-combobox">
  <label for="animal">Animal</label>
  <input
    id="animal"
    type="text"
    role="combobox"
    aria-autocomplete="inline"
    aria-controls="animals-listbox"
    aria-expanded="false"
    aria-haspopup="listbox" />
  <ul id="animals-listbox" role="listbox" aria-label="Animals">
    <li id="animal-cat" role="option">Cat</li>
    <li id="animal-dog" role="option">Dog</li>
  </ul>
</div>
js
let el = document.getElementById("animal");
console.log(el.ariaAutoComplete); // inline
el.ariaAutoComplete = "list";
console.log(el.ariaAutoComplete); // list

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser