Schematische Darstellung: Person mit weißem Stock gelangt über ein Boddenleitsystem zu einem Aufmerksamkeitsfeld

aria-autocomplete (Eigenschaft ) - Angaben zur automatischem Ausfüllen
[Materialsammlung]

26.08.2022

Mit dem Wert des Attributs aria-autocomplete können für Screen Reader Metainformationen über Ergänzungsvorschläge bei der Formulareingabe übergeben werden. (Vorhandensein und Ein-/Mehrzeiligkeit)

Technische Realisierung

Anwendung finden diese Hinweise auf dynamisch erweitertee Inhalte gegebenenfalls in einem Eingabefeld (textbox), insbesondere einem Suchfeld searchbox, oder einem kombinierten Eingabefeld (combobox).

Das Attribut besagt nicht von Vornherein, dass auch tatsächlich ein Ergänzungsvorschlag verfügbar ist.

Sein Wert sollte sich während der Eingabe nicht dynamisch ändern.

Hängen die Vorschläge nicht von den (ersten) Eingaben ab, sollte das Attribut nicht verwendet werden. Ein Suchfeld, in dem etwa unabhängig von der Eingabe lediglich die am häufigsten gesuchten Ausdrücke vorgeschlagen werden, benötigt das Attribut nicht oder erhält als Wert aria-autocomplete="none".

Werte für aria-autocomplete

inline: Bei der Eingabe erscheinen Ergänzungsvorschläge lediglich innerhalb der Eingabezeile.
Vorschläge werden während der Eingabe hinter dem Cursor ergänzt. Dies sollte auch durch die visuelle und technische Präsentation klar sein. (Browser Funktionalität)
Beim Verlassen des Eingabefelds oder beim Drücken von ENTER gilt der vorgeschlagene Wert als ausgewählt.
list: Während der Eingabe wird eine Sammlung von Ergänzungsvorschlägen außerhalb des Eingabefelds in einem eigenen Element eingeblendet.
Für diese Variante gibt es eine Reihe von zusätzlichen Anforderungen an den Einsatz von Elementen, ARIA-Attributen und die Tastaturbedienung. Zusätzlich gelten Anforderungen, wie sie für die Werte inline und list vorgegeben sind.
both: Während der Eingabe kann eine Sammlung von Ergänzungsvorschlägen eingeblendet werden. Ist ein Ergänzungsvorschlag vorhanden, wird er im Eingabefeld automatisch ausgewählt und hinter dem Cursor ergänzt.
none (Standard): Ergänzungsvorschläge sind nicht vorgesehen.

Beispiel

	
<input
  type="text"
  autocomplete 
  aria-autocomplete="inline">

Erläuterungen zum Codebeispiel

Als Typ für das Eingabefeld könnte anstelle von text zur Präzisierung auch der verfügbare Wert für E-Mail Adressen, einen Suchausdruck und Ähnliches stehen.
Das HTML5 Attribut autocomplete übergibt an den Browser allgemein die Information, dass Ergänzungsvorschläge zulässig sind.
Mit dem Wert inline wird angezeigt, dass bei der Eingabe lediglich hinter der Einfügemarke (dem Cursor) ein einzeiliger Ergänzungsvorschlag eingeblendet wird.

Verhalten von assistierenden Technologien

Der DOM-Fokus verbleibt während der Eingabe in der Eingabezeile, bis Tabulator oder ↓ gedrückt werden oder mit der Maus oder am Touch Screen eine Auswahl erfolgen.