Zum Hauptinhalt springen

Barrierefreies Suchfeld mit Vorschlägen implementieren (Tutorial)

Informationen zum Artikel

Porträtfoto von Dmitry Dugarev

Autor: Dmitry Dugarev

Berater für digitale Barrierefreiheit & IT-Compliance

Zuletzt aktualisiert am:

Ein barrierefreies Suchfeld mit Vorschlägen bauen

Ein Suchfeld, das beim Tippen Vorschläge einblendet, ist eines der nützlichsten – und am häufigsten falsch umgesetzten – Widgets im Web. In dieser Anleitung bauen wir es als das, was die WAI-ARIA Authoring Practices dafür vorsehen: eine Combobox mit Listbox-Popup [1]. Wir gehen das Stück für Stück durch, jeweils mit dem Warum, Do’s & Don’ts und kopierbarem Code.

Das Grundprinzip dieses Patterns: Der DOM-Fokus bleibt die ganze Zeit im Eingabefeld. Die gerade hervorgehobene Option wird nicht über echten Fokus, sondern über das Attribut aria-activedescendant verfolgt. Das klingt erst ungewohnt, ist aber der Schlüssel zu einer Suche, die sich mit der Tastatur und mit dem Screenreader natürlich anfühlt.

Erste Regel von ARIA

Nutze, wo möglich, natives HTML. Ein echtes <input> und ein <button> bringen Tastatur- und Fokusverhalten gratis mit – ARIA ergänzt nur die Beziehungen, die HTML nicht ausdrücken kann. [2]

Grundstruktur: die Combobox​

Die Sucheingabe ist ein echtes Texteingabefeld. Wir geben ihm role="combobox" und die Attribute, die der assistiven Technik sagen, dass es eine aufklappbare Vorschlagsliste „besitzt“.

<div class="search">
<input
id="search-input"
type="text"
role="combobox"
aria-label="Bestellungen durchsuchen"
aria-autocomplete="list"
aria-haspopup="listbox"
aria-expanded="false"
aria-controls="suggest-listbox"
/>
</div>

Worauf es ankommt:

  • aria-haspopup="listbox" ist der wichtigste und am häufigsten vergessene Teil. Ohne ihn weiß VoiceOver nicht, welche Art Popup sich öffnet, und behandelt die Vorschläge als Menü – jede Option wird dann als „Menüpunkt“ mit „Control-Option-Leertaste zum Auswählen“ angekündigt. Mit listbox werden sie korrekt als Optionen einer Liste angesagt. [3]
  • aria-expanded wechselt zwischen false (Liste geschlossen) und true (offen). [3]
  • aria-controls zeigt auf die id der Listbox, sobald sie sichtbar ist.
  • Das Feld braucht eine permanente Beschriftung – hier per aria-label, in einem Formular besser ein sichtbares <label>. [4]
Don’t

Baue die Combobox nicht aus einem <div> mit contenteditable oder einem <input type="search"> mit einem <ul role="menu"> nach. Ein Menü ist für Befehle (wie in einer App-Menüleiste), nicht für Vorschläge – die Tastaturkonventionen sind andere.

Checkliste für die Grundstruktur:​

  • Die Eingabe ist ein <input> mit role="combobox". [3], [5]
  • aria-haspopup="listbox", aria-autocomplete="list" und aria-expanded sind gesetzt. [3]
  • Das Feld hat eine permanente, verknüpfte Beschriftung. [4], [6]

Die Vorschlagsliste: eine Listbox​

Das Popup ist eine role="listbox" mit einer eigenen Beschriftung – nicht derselben wie das Eingabefeld, sonst kündigt der Screenreader beim Betreten „Bestellungen durchsuchen, Listbox“ an und es klingt wie eine zweite Suche. Besser: „Suchvorschläge“.

<ul id="suggest-listbox" role="listbox" aria-label="Suchvorschläge">
<li id="opt-0" role="option">Frau Berger</li>
<li id="opt-1" role="option">Sonnenberg-Schule</li>
</ul>

In der Praxis liegt das Popup aus Layout-Gründen oft als Geschwister-Element des Feldes im DOM (absolut positioniert), nicht als Kind. Damit der Screenreader-Lesefluss trotzdem vom Feld in die Vorschläge wandert (VoiceOver: VO + →), verweist aria-owns am Eingabefeld auf die Listbox. Das zieht sie im Accessibility-Baum direkt unter die Combobox – genau das macht auch die Google-Suche.

<input
role="combobox"
aria-controls="suggest-listbox"
aria-owns="suggest-listbox"
...
/>
hinweis

aria-controls darf statisch gesetzt bleiben (die Combobox-Rolle verlangt es); aria-owns setzt Du nur, während die Listbox tatsächlich gerendert ist – ein Verweis auf ein nicht existierendes Element wäre ungültig.

Checkliste für die Vorschlagsliste:​

  • Das Popup hat role="listbox" und eine eigene Beschriftung. [3], [7]
  • Liegt es nicht direkt hinter dem Feld, verweist aria-owns darauf. [6]

Optionen und Gruppen​

Jeder Vorschlag ist eine role="option" mit eindeutiger id. Sind die Vorschläge nach Kategorie gruppiert, wird daraus eine gruppierte Listbox nach WAI-ARIA: ein role="group" pro Kategorie, dessen sichtbare Überschrift die Gruppe über aria-labelledby benennt.

<div id="suggest-listbox" role="listbox" aria-label="Suchvorschläge">
<div role="group" aria-labelledby="grp-kunden">
<!-- Die Überschrift ist NICHT aria-hidden: der Screenreader landet beim
Hineinlesen darauf und sagt den Gruppennamen schon beim Betreten an. -->
<div id="grp-kunden" class="group-head">Kunden</div>
<div id="opt-0" role="option" aria-selected="false">Frau Berger</div>
<div id="opt-1" role="option" aria-selected="false">Selin Aydın</div>
</div>
<div role="group" aria-labelledby="grp-adressen">
<div id="grp-adressen" class="group-head">Adressen</div>
<div id="opt-2" role="option" aria-selected="false">Ahornweg, Friedberg</div>
</div>
</div>

Der häufige Fehler hier: die Gruppenüberschrift aria-hidden="true" zu setzen, um sie nur „optisch“ zu zeigen. Dann landet der Screenreader-Cursor beim Hineinlesen zwar auf der Überschrift, sagt aber nichts – der Nutzer erfährt erst am Ende der Gruppe, in welcher er war. Mache die Überschrift stattdessen zu einem echten, navigierbaren Knoten und verknüpfe sie per aria-labelledby. So ist sie zugleich der Name der Gruppe und ein Lese-Stopp, der den Gruppennamen beim Betreten ansagt. [6]

Don’t

Gib den Optionen kein role="menuitem". Eine Vorschlagsliste ist eine Listbox, kein Menü – und die Gruppenüberschrift ist keine auswählbare Option. [2]

Checkliste für Optionen und Gruppen:​

  • Jeder Vorschlag hat role="option" und eine eindeutige id. [3]
  • Gruppen nutzen role="group" mit einer navigierbaren Überschrift via aria-labelledby (nicht aria-hidden). [6], [7]

Tastatursteuerung​

Jetzt das Verhalten. Alle Tasten werden am Eingabefeld behandelt – der Fokus bleibt dort, wir verschieben nur einen virtuellen Zeiger (aria-activedescendant).

const input = document.getElementById('search-input');
let activeIndex = -1; // -1 = nichts hervorgehoben

input.addEventListener('keydown', (e) => {
switch (e.key) {
case 'ArrowDown':
e.preventDefault();
open();
setActive(Math.min(activeIndex + 1, options.length - 1));
break;
case 'ArrowUp':
e.preventDefault();
open();
// aus dem „nichts hervorgehoben“-Zustand auf die letzte Option springen
setActive(activeIndex < 0 ? options.length - 1 : Math.max(activeIndex - 1, 0));
break;
case 'Enter':
if (isOpen && activeIndex >= 0) {
e.preventDefault();
select(options[activeIndex]);
}
break;
case ' ': // Leertaste wählt nur, wenn schon eine Option hervorgehoben ist
if (isOpen && activeIndex >= 0) {
e.preventDefault();
select(options[activeIndex]);
}
break;
case 'Escape':
if (isOpen) {
e.preventDefault();
close(); // Liste schließen, Eingabe NICHT leeren
}
break;
}
});

function setActive(i) {
activeIndex = i;
options.forEach((opt, idx) => opt.setAttribute('aria-selected', String(idx === i)));
// den virtuellen Fokus setzen – der echte Fokus bleibt im Feld
input.setAttribute('aria-activedescendant', i >= 0 ? options[i].id : '');
}

Die wichtigste Regel hier: Beim Tippen wird nichts automatisch hervorgehoben. Setzt Du aria-activedescendant schon nach dem ersten Zeichen, reißt es den VoiceOver-Cursor mitten im Wort in die Liste – und der Nutzer kann nicht weitertippen. Wie bei Google bleibt aria-activedescendant leer, bis der Nutzer ↓ drückt. [8], [9]

Damit ein Screenreader eine Option auch beim Lesen der Liste mit VO + Leertaste auswählen kann (nicht nur per Enter aus dem Feld), reagieren die Optionen zusätzlich auf click:

options.forEach((opt) => {
// mousedown nur, um den Fokus im Feld zu halten (kein Blur → Popup bleibt offen)
opt.addEventListener('mousedown', (e) => e.preventDefault());
opt.addEventListener('click', () => select(opt));
});

Checkliste für die Tastatursteuerung:​

  • Tippen löst keine Auto-Hervorhebung aus. [8], [9]
  • ↑/↓ navigieren, Enter/Leertaste wählen, Esc schließt (ohne zu leeren). [8]
  • Optionen sind auch per click aktivierbar (für VO + Leertaste). [8]

Fokusmanagement​

Zwei Fallen, an denen Comboboxen für Screenreader regelmäßig scheitern:

1. Die Liste darf nicht beim bloßen Blur verschwinden. Wenn VoiceOver (mit „Fokus folgt VoiceOver-Cursor“) in die Vorschläge wandert, blurrt das Eingabefeld. Schließt Du die Liste bei jedem Blur, wird sie genau dann abgebaut, wenn der Nutzer sie erreicht – sie verschwindet als „keine Optionen“ und der Cursor steht im Nichts. Schließe deshalb nur, wenn Fokus oder Zeiger das gesamte Steuerelement verlassen:

// NICHT: input.addEventListener('blur', close)
const root = document.querySelector('.search');

root.addEventListener('focusout', (e) => {
// offen lassen, wenn der Fokus innerhalb des Steuerelements bleibt (oder ins Nichts geht)
if (e.relatedTarget && !root.contains(e.relatedTarget)) close();
});
document.addEventListener('pointerdown', (e) => {
if (!root.contains(e.target)) close();
});

2. Nach der Auswahl muss der Fokus klar zurück ins Feld. Beim Auswählen schließt sich die Liste und die aktivierte Option verschwindet – der Screenreader-Cursor steht sonst „im Nichts“. Erzwinge die Rückkehr ins Feld:

function select(option) {
applyFilter(option); // Ergebnisse aktualisieren
announce(`Filter ${option.textContent} hinzugefügt`); // siehe nächster Schritt
close();
// blur()+focus() erzwingt das Fokus-Event, damit der Screenreader sich wieder aufs Feld setzt
requestAnimationFrame(() => {
input.blur();
input.focus();
});
}

Checkliste für das Fokusmanagement:​

  • Die Liste bleibt offen, solange der Nutzer sie erkundet; sie schließt erst, wenn Fokus/Zeiger das ganze Steuerelement verlassen. [9]
  • Nach der Auswahl kehrt der Fokus zuverlässig ins Eingabefeld zurück. [9], [10]

Änderungen für Screenreader ansagen​

Wenn sich die Ergebnisliste unter dem Nutzer ändert, muss das angesagt werden – sonst ist die Änderung für blinde Nutzer unsichtbar. Dafür gibt es eine Live-Region: ein visuell verstecktes Element mit role="status", das bereits im DOM steht, bevor sich sein Text ändert. [11], [12]

<div role="status" aria-live="polite" class="visually-hidden" id="search-status"></div>
function announce(message) {
// Den Text aktualisieren – eine bestehende, beobachtete Region wird zuverlässig vorgelesen.
document.getElementById('search-status').textContent = message;
}

// Trefferzahl ansagen, wenn sich die Ergebnisse ändern:
announce(`${resultCount} Ergebnisse`);

Zwei Dinge, die Ansagen verschlucken:

  • Ein gleichzeitiger Fokuswechsel leert die Sprach-Warteschlange des Screenreaders. Da unser Fokus im Feld bleibt, ist das hier kein Problem – bei „Auswahl schließt ein Modal“-Fällen aber schon: dann die Ansage erst nach dem Schließen absetzen.
  • Eine Region, die zugleich neu erzeugt und befüllt wird, wird oft übersprungen. Lass die Region dauerhaft im DOM stehen und ändere nur ihren Text.

Checkliste für die Ansagen:​

  • Eine role="status"/aria-live="polite"-Region sagt die Trefferzahl an. [11], [12]
  • Die Auswahl wird angesagt, da die aktivierte Option verschwindet. [11]
  • Keine Ansage wird durch einen gleichzeitigen Fokuswechsel verschluckt. [11]

Sichtbarer Fokus mit ausreichend Kontrast​

Die per Tastatur hervorgehobene Option ist ein Fokus-Indikator – und der braucht nach WCAG 2.2 mindestens 3:1 Kontrast zur nicht-hervorgehobenen Option. Ein zarter Hintergrundwechsel (etwa Weiß → sehr helles Grau) liegt oft bei ~1:1 und genügt damit nicht. [10], [13]

/* Don't: nur ein zarter Hintergrund (~1:1 Kontrast, fällt durch) */
.option[aria-selected='true'] {
background: #f4f2ec;
}

/* Do: zusätzlich ein deutlicher Ring (hier ≈4,5:1 auf der Oberfläche).
Innenliegend (inset), damit der Rand des Popups ihn nicht abschneidet. */
.option[aria-selected='true'] {
background: #f4f2ec;
box-shadow: inset 0 0 0 2px #c81e43;
}

Achte zusätzlich darauf, dass der Optionstext auf dem hervorgehobenen Hintergrund weiterhin 4,5:1 erreicht. [14]

Checkliste für den sichtbaren Fokus:​

  • Die hervorgehobene Option hat einen Indikator mit ≥ 3:1 Kontrast. [10], [13]
  • Der Optionstext erfüllt 4,5:1 auf dem hervorgehobenen Hintergrund. [14]

Fazit​

Eine barrierefreie Suche ist kein Hexenwerk, aber sie steht und fällt mit Details, die man im DOM nicht sieht: aria-haspopup, das Fokus im Feld hält, eine Liste, die beim Erkunden nicht verschwindet, navigierbare Gruppenüberschriften und ein Fokus-Indikator mit echtem Kontrast. Halte Dich an das Combobox-Pattern der WAI-ARIA APG [1], teste mit echter assistiver Technik – und Du hast ein Suchfeld, das für alle funktioniert.

Häufig gestellte Fragen (FAQ) zu barrierefreien Suchfeldern​

Warum kündigt VoiceOver meine Vorschläge als „Menüpunkt“ an?​

Weil dem Combobox-Eingabefeld aria-haspopup="listbox" fehlt. Ohne dieses Attribut nimmt VoiceOver ein Menü an und liest die Optionen mit Menü-Konventionen vor. Setze aria-haspopup="listbox" am Eingabefeld. [3]

Soll der Fokus in die Vorschlagsliste wandern oder im Feld bleiben?​

Er bleibt im Feld. Das ist der Kern des Combobox-Patterns mit aria-activedescendant: Du verschiebst nur einen virtuellen Zeiger, der echte DOM-Fokus verlässt das Eingabefeld nie. So kann der Nutzer jederzeit weitertippen. [9]

role="option" oder role="menuitem" für die Vorschläge?​

role="option". Eine Vorschlagsliste ist eine Listbox, kein Menü. menuitem gehört in echte Menüs (z.B. eine App-Menüleiste) mit anderen Tastaturkonventionen. [2]

Warum verschwindet meine Vorschlagsliste, sobald der Screenreader sie erreicht?​

Vermutlich schließt Du sie beim blur des Eingabefeldes. VoiceOver blurrt das Feld, wenn sein Cursor in die Liste wandert – und reißt sie so unter dem Nutzer ab. Schließe stattdessen nur, wenn der Fokus das gesamte Steuerelement verlässt. [9]

Wie teste ich, ob meine Suche barrierefrei ist?​

Lege die Maus weg und bediene alles nur mit der Tastatur. Schalte dann einen echten Screenreader ein (VoiceOver auf macOS, NVDA auf Windows) und navigiere mit Lese-Cursor in die Vorschläge. Die meisten Combobox-Fehler zeigen sich erst dort – nicht im DOM-Inspektor.

​

  1. W3C Web Accessibility Initiative, „WAI-ARIA Authoring Practices 1.2“. 2021. [Online]. Verfügbar unter: https://www.w3.org/TR/wai-aria-practices/ ⤴
  2. W3C Web Accessibility Initiative (WAI), „W3C Using Aria: Erste Regel der ARIA-Nutzung“. 2018. [Online]. Verfügbar unter: https://www.w3.org/TR/using-aria/#firstrule ⤴
  3. W3C, „Success Criterion 4.1.2 Name, Role, Value“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#name-role-value ⤴
  4. W3C, „Success Criterion 3.3.2 Labels or Instructions“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#labels-or-instructions ⤴
  5. W3C, „ARIA4: Using a WAI-ARIA role to expose the role of a user interface component“, 2023, [Online]. Verfügbar unter: https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA4 ⤴
  6. W3C, „Success Criterion 1.3.1 Info and Relationships“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#info-and-relationships ⤴
  7. W3C, „ARIA13: Using aria-labelledby to name regions and landmarks“, 2023, [Online]. Verfügbar unter: https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA13 ⤴
  8. W3C, „Success Criterion 2.1.1 Keyboard“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#keyboard ⤴
  9. W3C, „Success Criterion 2.4.3 Focus Order“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#focus-order ⤴
  10. W3C, „Success Criterion 2.4.7 Focus Visible“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#focus-visible ⤴
  11. W3C, „Success Criterion 4.1.3 Status Messages“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#status-messages ⤴
  12. W3C Web Accessibility Initiative (WAI), „WAI-ARIA 1.2: aria-live“. 2021. [Online]. Verfügbar unter: https://www.w3.org/TR/wai-aria-1.2/#aria-live ⤴
  13. W3C, „Success Criterion 1.4.11 Non-text Contrast“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#non-text-contrast ⤴
  14. W3C, „Success Criterion 1.4.3 Contrast (Minimum)“, 2023, [Online]. Verfügbar unter: https://www.w3.org/TR/WCAG22/#contrast-minimum ⤴

Über den Autor

Porträtfoto von Dmitry Dugarev

Beste Grüße

Dmitry Dugarev

Gründer von Barrierenlos℠. Ich prüfe Websites von Hand und behebe die Barrieren auf WordPress-Websites – ohne Relaunch.