Feststelltasten-Code (Caps Lock)

Die Feststelltaste (Caps Lock) sendet event.key „CapsLock“, event.code „CapsLock“ und keyCode 20.

Alle Werte auf einen Blick

Werte für Feststelltaste
Tasteevent.codeevent.keykeyCodeevent.location
FeststelltasteCapsLockCapsLock200 (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 Feststelltaste

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

Code, der auf Feststelltaste reagiert

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

Welchen Wert du nutzen solltest

Willst du wissen, ob die Feststelltaste an ist, beobachte nicht die Taste. Frage ein beliebiges Tasten- oder Mausereignis: event.getModifierState('CapsLock') ist true, solange sie an ist. Das klappt auch, wenn die Feststelltaste schon vor dem Laden der Seite eingeschaltet war.

Willst du auf die Taste selbst reagieren, prüfe event.key === 'CapsLock' (event.code ist gleich). keyCode ist 20, aber veraltet.

Die Feststelltaste ändert event.key bei Buchstaben („A“ statt „a“), aber nicht event.code oder keyCode.

Wo es oft hakt

Meine Warnung „Feststelltaste ist an“ stimmt nicht

Das Zählen der Tastendrücke geht schief, sobald die Feststelltaste schon vor dem Öffnen der Seite an war. Lies den Zustand stattdessen bei jedem Ereignis im Passwortfeld:

function checkCaps(event) {
  warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);

Blende die Warnung bei blur aus. Der Zustand ist erst bekannt, wenn jemand eine Taste drückt oder die Maus bewegt. Beim Laden der Seite kannst du ihn nicht abfragen.

Am Mac sendet die Feststelltaste nur ein Ereignis

Unter Windows und Linux sendet die Feststelltaste keydown und keyup wie jede Taste. Am Mac senden Chrome und Safari nur ein keydown, wenn sie angeht, und nur ein keyup, wenn sie ausgeht. Firefox am Mac sendet jedes Mal nur ein keydown. Darum lauscht die Warnung oben auf beide.

Der Zustand beim eigenen Ereignis der Taste ist alt

Beim Ereignis der Feststelltaste selbst sind sich die Browser uneinig, ob getModifierState schon den neuen Zustand zeigt. Prüfe ihn bei der nächsten Taste oder bei keyup noch einmal.

Ein kurzes Antippen schaltet sie nicht ein (Mac)

macOS ignoriert ein sehr kurzes Antippen der Feststelltaste, damit du sie bei einer flüchtigen Berührung nicht versehentlich einschaltest. Deine Seite sieht vielleicht das Ereignis, während die Leuchte aus bleibt. Verlass dich auf getModifierState, nicht auf die Zahl der Ereignisse.

Handys melden nie, dass die Feststelltaste an ist

Bildschirmtastaturen haben ihre eigene Dauer-Großschreibung (Umschalt doppelt antippen). Diese sendet keine CapsLock-Ereignisse, und getModifierState('CapsLock') bleibt false. Nur eine Hardware-Tastatur meldet den Zustand der Feststelltaste.

Feststelltaste in Spielen und Kürzeln

Nutze die Feststelltaste nicht als Haltetaste: Am Mac bekommst du kein keyup, solange sie gedrückt ist. Manche belegen sie auch mit Strg oder Esc neu, und dann bekommt die Seite diese Taste. Safari am Mac zeigt in Passwortfeldern schon ein eigenes Symbol für die Feststelltaste, darum erscheint deine Warnung dort vielleicht doppelt.