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.
<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>
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