Keycode der Tab-Taste

Tab sendet event.key „Tab“, event.code „Tab“ und keyCode 9, mit oder ohne Umschalt.

Alle Werte auf einen Blick

Werte für Tab
Tasteevent.codeevent.keykeyCodeevent.location
TabTabTab90 (Standard)

keyCode so, wie Chrome und Edge ihn unter Windows senden. Die Mac-Spalte (Chrome und Safari am Mac) und die Firefox-Spalte zeigen nur Zahlen, die abweichen. Manche Tasten unterscheiden sich auch je nach System, wie der Text unten sagt. event.which ist immer dieselbe Zahl wie keyCode. event.key gilt für ein US-Layout ohne Umschalt.

Hier drücken

Klicke hier und drücke dann Tab

Du nutzt nur die Tastatur? Drücke Esc und dann Tab, um das Tastenfeld zu verlassen.

Code, der auf Tab reagiert

Empfohlen: event.key prüfen
document.addEventListener('keydown', (event) => {
  if (event.key === 'Tab') {
    // Dein Code hier
  }
});
Platz der Taste prüfen: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Tab') {
    // Dein Code hier
  }
});
Alter Code, der noch keyCode nutzt (veraltet)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 9) {
    // Dein Code hier
  }
});

Welchen Wert du nutzen solltest

Prüfe event.key === 'Tab'. Es gibt eine Tab-Taste, und sie sendet auf jedem Layout denselben Wert. Auch event.code ist "Tab".

Umschalt + Tab sendet weiterhin "Tab": Umschalt ändert den Namen der Taste nicht. Prüfe event.shiftKey, um beides zu unterscheiden.

keyCode 9 kommt in jedem Browser noch an, ist aber veraltet.

Wo es oft hakt

keyup kommt bei einem anderen Element an

Tab verschiebt den Fokus bei keydown. Das keydown geht also an das Feld, das du verlässt, und das keyup an das Feld, in dem du ankommst. Ein keyup-Handler an einem Feld sieht Tab jedes Mal, wenn jemand in das Feld hineintabt. Behandle Tab bei keydown.

Wer die Tastatur nutzt, bleibt in meinem Widget hängen

Rufst du bei Tab preventDefault() auf, wandert der Fokus nie weiter. Wer die Tastatur nutzt, kommt dann nicht mehr heraus. Ohne anderen Ausweg verstößt das gegen WCAG 2.1.2, Keine Tastaturfalle. Stoppe Tab nur aus gutem Grund, etwa bei einem modalen Dialog, der den Fokus bei sich hält, solange er offen ist. Gib dann einen klaren Ausweg: Esc oder einen Schließen-Button.

Tab in meinem Textfeld verlässt das Feld, statt einzurücken

Das ist die Voreinstellung, und die meisten wollen das so. In einem Code-Editor kannst du stattdessen einen Tabulator einfügen:

if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}

Biete immer einen Ausweg an, wie auf der Seite „Keycode ermitteln“: Drücke zuerst Esc, dann geht Tab weiter. Eine Änderung mit setRangeText() landet nicht im Rückgängig-Verlauf. Mit document.execCommand('insertText', false, '\t') lässt sie sich rückgängig machen, doch die Methode ist veraltet.

Strg+Tab und Alt+Tab erreichen die Seite nie

Browser und Computer behalten sie für sich: Strg + Tab wechselt den Browser-Tab, Alt + Tab (am Mac Cmd + Tab) wechselt die App. Deine Seite sieht vielleicht das keydown von Strg oder Alt und danach nichts. Nach der Rückkehr kann eine Zusatztaste noch als gedrückt gelten, weil ihr keyup an ein anderes Fenster ging. Setze den Zustand der Zusatztasten beim blur-Ereignis des Fensters zurück.

Safari am Mac springt standardmäßig nur zwischen Formularfeldern. Mit Wahltaste + Tab erreichst du jedes Element. Oder öffne in den Safari-Einstellungen „Erweitert“ und aktiviere „Über Tabulator jedes Objekt auf einer Webseite hervorheben“. Teste deine Tab-Reihenfolge mit dieser Einstellung, und nimm nicht an, dass man am Mac einen Button allein mit Tab erreicht.

Tab-Reihenfolge

Tab folgt der Reihenfolge der Elemente im HTML. tabindex="0" nimmt ein Element in diese Reihenfolge auf, tabindex="-1" nimmt es heraus. Meide positive Zahlen: Sie springen vor alles andere und verwirren die Leute.