Zum Inhalt springen

Suche

Barrierefreie Tabs, mit CSS, das den Zustand liest

A11yJavaScriptCSS

Das ARIA-Pattern für Tabs wirkt klein, steckt aber voller Entscheidungen. Hier sind Markup, Tastatur-Code und ein CSS, das nicht von dem abweichen kann, was Screenreader hören, mit einer Position zu jedem strittigen Punkt.

von
10 Min. Lesezeit

Wie schwer kann eine Reihe Buttons mit einem sichtbaren Panel sein? Schwer genug, dass sich Fachleute bei Teilen davon bis heute uneinig sind. Und ein Screenreader-Bug rund um Tabs ist seit 2018 offen.

TL;DR

Nimm <button>-Tabs mit automatischer Aktivierung und Roving tabindex, und style jeden Zustand über sein ARIA-Attribut statt über eine Klasse. Verstecke Panels mit hidden="until-found", damit die Suche im Browser sie weiter findet, und mach das sichtbare Panel fokussierbar.

Markup und Zustand

Tabs passen zu verwandten Inhalten, die sich einen Platz auf der Seite teilen: die Tarife einer Preistabelle, die Einstellungen eines Objekts. Für Inhalte ohne Zusammenhang passen sie nicht. TetraLogical nennt „unrelated sections of content (use separate pages instead)“ ausdrücklich als Fall, in dem wir keine Tabs nehmen sollten. Und wenn jeder „Tab“ eine eigene Seite lädt, ist das Navigation: ein <nav> mit Links und aria-current="page", ganz ohne Skript.

Der Vertrag

tabs.html
<h2 id="plans">Tarife</h2>
<div role="tablist" aria-labelledby="plans">
  <button type="button" role="tab" id="t1" aria-controls="p1" aria-selected="true">Free</button>
  <button type="button" role="tab" id="t2" aria-controls="p2" aria-selected="false" tabindex="-1">Pro</button>
</div>
<div role="tabpanel" id="p1" aria-labelledby="t1" tabindex="0">…</div>
<div role="tabpanel" id="p2" aria-labelledby="t2" hidden="until-found">…</div>

Jedes Attribut hat eine Aufgabe. Die Tablist bekommt ihren Namen von einer sichtbaren Überschrift. Jeder Tab trägt aria-selected (genau einer ist true) und zeigt mit aria-controls auf sein Panel. Nicht ausgewählte Tabs bekommen tabindex="-1". Dieser Roving Tabindex lässt genau einen Tab in der Tab-Reihenfolge, den Rest erreichen die Pfeiltasten. Jedes Tabpanel zeigt mit aria-labelledby zurück. Das ist keine Kür: In WAI-ARIA 1.2 braucht ein Tabpanel einen Namen, und der kommt vom Autor.

Einen Tab auszuwählen ist eine Aktion. Sie ändert, was diese Seite zeigt, und führt nirgendwohin. Ein <button> bringt Enter und Leertaste mit und lässt URL und Verlauf in Ruhe.

Links sind auch erlaubt. TetraLogical und Heydon Pickering bauen ihre Tabs aus Sprunglinks, damit alles auch ohne JavaScript funktioniert. Das ist ein guter Grund. Er kostet ein preventDefault() bei jedem Klick und einen eigenen Handler für die Leertaste, weil Links nur auf Enter reagieren.

Styling aus dem Zustand

Ich style Tabs nur über die Attribute oben, nie über Klassen wie .is-active:

tabs.css
[role='tab'][aria-selected='true'] {
  font-weight: 700;
  border-color: currentColor;
}

[role='tab']:focus-visible {
  outline: 2px solid;
  outline-offset: 2px;
}

[role='tabpanel']:not([hidden]) {
  display: grid;
  gap: 0.5rem;
  padding: 1rem;
}

Vergisst das Skript, aria-selected zu setzen, stimmt auch die Optik nicht. Den Fehler sehen dann alle, nicht nur Screenreader-Nutzer. Das CSS wird zum Test für das ARIA.

Achte auf das :not([hidden]). Mit [role="tabpanel"] { display: grid } siehst du alle Panels auf einmal, weil deine Regel die Browser-Regel [hidden] { display: none } schlägt.

Achtung: Forced Colors entfernen Schatten

Im Forced-Colors-Modus werden box-shadow und text-shadow zu none, und Hintergründe werden ersetzt. Ein Auswahlzustand nur aus Schatten oder Hintergrund verschwindet. Ein Rahmen bleibt, deshalb zeichnet TetraLogical „a thicker top border instead“.

Tastatur

Automatische Aktivierung

Bei automatischer Aktivierung wählt der Fokus den Tab gleich mit aus. Bei manueller Aktivierung bewegen die Pfeile nur den Fokus, ausgewählt wird mit Enter oder Leertaste. Ich empfehle die automatische Variante, und die APG tut das auch, mit einer Bedingung:

It is recommended that tabs activate automatically when they receive focus as long as their associated tab panels are displayed without noticeable latency.

— WAI-ARIA Authoring Practices: Tabs pattern

Muss ein Panel seinen Inhalt erst laden, wartet jeder Pfeiltasten-Druck darauf. Dann wechsle ich zur manuellen Aktivierung. Beim Bauen beider Varianten kamen zwei weitere Gründe dazu. Bei manueller Aktivierung laufen Fokus und Auswahl auseinander: Geh mit den Pfeilen auf „Team“, ohne ihn zu aktivieren, drück Tab, und du landest im Panel „Free“, das noch angezeigt wird. Und der Workaround für den Screenreader-Bug weiter unten funktioniert nur mit automatischer Aktivierung.

Taste Wirkung
→ / ← Nächster oder vorheriger Tab, am Ende wieder von vorn
Pos1 / Ende Erster oder letzter Tab
Tab Verlässt die Tablist, nächster Halt ist das Panel
↑ / ↓ Nichts in einer horizontalen Tablist, die Seite scrollt

Ruf preventDefault() nur für die Tasten auf, die du selbst behandelst, nie für Tab. Und lass den Klick-Handler selbst focus() aufrufen: Safari fokussiert einen Button beim Klick nicht. Ohne den Aufruf laufen Tab-Stopp und Tastatur-Position getrennte Wege.

Vertikale Tabs

Mit aria-orientation="vertical" übernehmen ↓ und ↑. Ohne das Attribut ist eine Tablist horizontal. Ich lese die Ausrichtung im Tasten-Handler, nicht einmal beim Start, damit ein responsives Layout sie umschalten kann:

tabs.js
const vertical = tablist.ariaOrientation === 'vertical';
const [prevKey, nextKey] = vertical ? ['ArrowUp', 'ArrowDown'] : ['ArrowLeft', 'ArrowRight'];

Das Layout folgt dem Attribut, nicht umgekehrt. :has(> [role="tablist"][aria-orientation="vertical"]) stellt die Tabs neben die Panels.

Was ← und → in einer vertikalen Tablist tun sollen, ist nicht festgelegt. Eine Frage dazu auf der APG-Mailingliste blieb 2023 unbeantwortet. Ich lasse beide ohne Funktion, analog zur APG-Regel für ↑ und ↓ in horizontalen Tablists. Der Preis: Wer die falsche Achse rät, bekommt keine Rückmeldung. Auch Rechts-nach-links-Layouts sind offen, in einem APG-Issue vom Juli 2020.

Sonderfälle

Soll das Panel fokussierbar sein?

Hier gehen die Meinungen am weitesten auseinander. TetraLogical lässt Panels aus der Tab-Reihenfolge heraus. Pickering gibt ihnen tabindex="-1" und setzt den Fokus mit ↓ hinein. Die APG verlangt ein fokussierbares Panel, wenn „the first element with content is not focusable“.

Ich gehe einen Schritt weiter als die APG: Das sichtbare Panel bekommt immer tabindex="0". Tab landet dann immer auf dem Panel. In meinem Test mit Safari hat VoiceOver den Panel-Namen „Free“ angesagt. Ohne tabindex wurde das reine Text-Panel übersprungen, und der Fokus sprang zum nächsten Link.

Der Preis ist ein zusätzliches Tab bei Panels, die mit einem Link beginnen, und ein Fokusrahmen um einen Container, der nichts tut. TetraLogical vermeidet diesen Halt bewusst. Ich nehme ihn in Kauf, damit sich jedes Panel gleich verhält. Nimm für diesen Rahmen :focus-visible, nicht :focus-within. Sonst bleibt er stehen, solange ein Element im Panel den Fokus hat.

Suche im Browser mit hidden=“until-found”

Mit einfachem hidden findet die Suche im Browser keinen Text in einem nicht ausgewählten Panel, und ein Link dorthin führt ins Leere. hidden="until-found" löst beides. Findet der Browser einen Treffer im Panel, löst er dort beforematch aus, entfernt hidden und scrollt hin. Unsere Aufgabe: in diesem Event den passenden Tab auswählen, ohne den Fokus zu bewegen. Du hast gesucht, nicht zur Tablist navigiert.

Chrome, Edge und Firefox 148 unterstützen das. Safari fällt auf einfaches hidden zurück, so wie es die HTML-Spezifikation vorsieht. Die Tabs funktionieren dort, nur Suche und Deep Links nicht.

Drei Details haben mich überrascht. Ein so verstecktes Panel ist nicht display: none. Es bekommt content-visibility: hidden und behält eine leere Box, kann also weiter den Fokus bekommen. Ich habe das in Chrome 155 geprüft: Mit tabindex="0" auf einem versteckten Panel landet focus() darauf. tabindex="0" muss also mit der Auswahl wandern.

Die leere Box bleibt außerdem in Chromes Accessibility Tree, als leeres Tabpanel mit dem Namen seines Tabs. Mit einfachem hidden ist sie weg. aria-hidden="true" auf den versteckten Panels nimmt sie wieder heraus, und die Suche im Browser findet sie trotzdem. Das Skript entfernt es am ausgewählten Panel.

Und in einem vertikalen Grid-Layout belegt die Box eine Zeile und schiebt das sichtbare Panel unter die Tabs:

tabs.css
/* nie display oder visibility setzen, das bricht die Suche */
[role='tabpanel'][hidden='until-found' i] {
  position: absolute;
}

Der Browse-Mode-Bug

Scott O’Hara hat 2018 beschrieben, dass NVDA und JAWS im Browse Mode den Fokus auf den falschen Tab setzen:

If a screen reader were not running, a tab with a -1 tabindex would not receive keyboard focus.

— Scott O’Hara: Trouble Tabbing To Tabs

Die Bug-Reports für beide Screenreader sind weiter offen. Im NVDA-Issue erklärt ein Entwickler den Grund: Der Screenreader kann Elemente, die nur per Skript fokussierbar sind, nicht von per Tastatur fokussierbaren unterscheiden. O’Hara schlägt eine Übergangslösung vor, einen focusin-Listener, der den Fokus zum ausgewählten Tab schickt. Laut O’Hara verhält sich NVDA dann richtig, JAWS fokussiert den richtigen Tab, sagt ihn aber nicht an.

Ich empfehle die Übergangslösung nur mit automatischer Aktivierung. Bei manueller Aktivierung fokussieren die Pfeile absichtlich nicht ausgewählte Tabs, und der Listener schickt den Fokus sofort zurück. Das habe ich im Browser bestätigt, ohne Screenreader. NVDA und JAWS habe ich nicht getestet.

Was ich getestet habe, und das ganze Skript

  • VoiceOver mit Safari unter macOS: Tab in ein reines Text-Panel, mit und ohne tabindex="0".
  • Chrome 155: ob ein Panel mit hidden="until-found" und tabindex="0" den Fokus bekommt, mit einfachem hidden als Gegenprobe, und ob es im Accessibility Tree bleibt.
  • Tastatur: 20 automatisierte Tests in Chrome für das Skript unten, für automatische Aktivierung, vertikale Ausrichtung und until-found.
  • Nicht getestet: NVDA, JAWS, Firefox und die VoiceOver-Ansagen bei manueller Aktivierung und vertikalen Tablists.

Alles oben in einem Skript:

tabs.js
for (const tablist of document.querySelectorAll('[role="tablist"]')) {
  const tabs = [...tablist.querySelectorAll('[role="tab"]')];
  const panelOf = (tab) => document.getElementById(tab.getAttribute('aria-controls'));

  function select(tab, { focus = true } = {}) {
    for (const t of tabs) {
      const selected = t === tab;
      const panel = panelOf(t);
      t.ariaSelected = String(selected);
      if (selected) t.removeAttribute('tabindex');
      else t.tabIndex = -1;
      panel.hidden = selected ? false : 'until-found';
      if (selected) panel.removeAttribute('aria-hidden');
      else panel.ariaHidden = 'true'; // Chrome lässt until-found-Panels sonst im Accessibility Tree
      if (selected) panel.tabIndex = 0;
      else panel.removeAttribute('tabindex');
    }
    if (focus) tab.focus();
  }

  tablist.addEventListener('click', (e) => {
    const tab = e.target.closest('[role="tab"]');
    if (tab) select(tab);
  });

  tablist.addEventListener('keydown', (e) => {
    const i = tabs.indexOf(e.target.closest('[role="tab"]'));
    if (i === -1) return;
    const vertical = tablist.ariaOrientation === 'vertical';
    const [prevKey, nextKey] = vertical ? ['ArrowUp', 'ArrowDown'] : ['ArrowLeft', 'ArrowRight'];
    const last = tabs.length - 1;
    const next = {
      [nextKey]: i === last ? 0 : i + 1,
      [prevKey]: i === 0 ? last : i - 1,
      Home: 0,
      End: last,
    }[e.key];
    if (next === undefined) return;
    e.preventDefault();
    select(tabs[next]);
  });

  // Suche oder Sprunglink hat ein verstecktes Panel geöffnet: Tabs nachziehen, Fokus bleibt.
  tablist.parentElement.addEventListener('beforematch', (e) => {
    const panel = e.target.closest('[role="tabpanel"]');
    const tab = panel && tabs.find((t) => panelOf(t) === panel);
    if (tab) select(tab, { focus: false });
  });

  // Übergangslösung für den Browse Mode in NVDA und JAWS (O'Hara 2018). Nur bei automatischer Aktivierung.
  tablist.addEventListener('focusin', (e) => {
    const selected = tabs.find((t) => t.ariaSelected === 'true');
    if (e.target !== selected) selected.focus();
  });
}

Fazit

Das meiste am Tabs-Pattern ist geklärt. Panel-Fokus, Link-Tabs und die Pfeiltasten in vertikalen Tablists sind es nicht, und der Browse-Mode-Bug zeigt, dass Markup allein nicht alles löst. Falls du mit NVDA oder JAWS testest: Braucht es die Übergangslösung 2026 noch?

Zum Weiterlesen

Geschrieben von

Oliver Scheffler

Ich baue seit 25 Jahren Websites und schreibe hier über Frontend, Barrierefreiheit und Performance – meistens über Dinge, an denen ich mir selbst die Zähne ausgebissen habe.

Das <details>-Element ohne JavaScript animieren

CSSA11yPerformance

Mit interpolate-size und ::details-content klappt das <details>-Element weich auf und zu. Browser ohne Unterstützung öffnen es sofort, wie bisher.

6 Min. Lesezeit