Esc-Tastencode (Escape)

Esc sendet event.key „Escape“, event.code „Escape“ und keyCode 27.

Alle Werte auf einen Blick

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

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

Code, der auf Escape reagiert

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

Welchen Wert du nutzen solltest

Prüfe event.key === 'Escape'. Es gibt nur eine Esc-Taste, und sie sendet auf jedem Layout denselben Wert. event.key und event.code sagen hier also dasselbe. key liest sich besser.

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

Sehr alte Browser sendeten stattdessen "Esc": Internet Explorer und Firefox 36 und älter. Akzeptiere beides nur, wenn du sie noch unterstützt.

Wo es oft hakt

Esc verlässt das Vollbild, und mein Handler kann es nicht stoppen

Im Vollbild (und bei gesperrtem Mauszeiger) gehört Esc dem Browser. Esc beendet dann immer den Vollbildmodus oder gibt den Mauszeiger frei, und preventDefault() hilft nicht. Dein Handler sieht dieses Esc vielleicht gar nicht. Lausche auf fullscreenchange, um zu erfahren, dass es passiert ist. In Chromium kann ein Spiel im Vollbild navigator.keyboard.lock(['Escape']) aufrufen. Zum Beenden muss man Esc dann gedrückt halten.

Der Dialog schließt sich, obwohl ich das Schließen abgebrochen habe

Ein modales <dialog> schließt sich bei Esc von selbst. Es feuert zuerst ein cancel-Ereignis, das du stoppen kannst:

dialog.addEventListener('cancel', (event) => event.preventDefault());

Chrome lässt dich das nur einmal stoppen: Drückst du Esc ein zweites Mal, ohne dazwischen irgendwo zu klicken, schließt es sich trotzdem. Soll ein Dialog absichtlich offen bleiben, setze closedby="none", wo es unterstützt wird. Speichere die Arbeit der Person im Ereignis close, statt dich auf cancel zu verlassen.

Esc schließt zwei Dinge auf einmal

Ist ein Menü in einem Dialog offen, hören beide dasselbe Esc. Schließe nur das innerste Ding: Behandle Esc am Menü und rufe dann event.stopPropagation() auf, damit dein Dialog-Code nicht läuft. Rufe auch event.preventDefault() auf, damit sich ein natives <dialog> nicht ebenfalls schließt: Das Schließen ist die Standardaktion des Browsers, kein Handler.

Esc in einem Suchfeld leert es

In Chrome und einigen anderen Browsern leert Esc ein <input type="search">. Soll Esc stattdessen dein Suchfeld schließen, rufe bei keydown preventDefault() auf. Oder leere und schließe in einem Schritt.

Eine iPad-Tastatur hat keine Esc-Taste

Manche iPad-Tastaturen haben keine Esc-Taste, und Handys haben nie eine. Biete immer auch eine sichtbare Schließen-Schaltfläche an. Esc ist ein Kürzel, nicht der einzige Ausweg.

Esc als Ausweg

Wer mit der Tastatur arbeitet, erwartet, dass Esc Menüs, Pop-ups und Dialoge schließt und den Fokus zurück auf die Schaltfläche setzt, die sie geöffnet hat. Fängt ein Element jede Taste ab, wie ein Code-Editor oder das Feld auf der Seite „Keycode ermitteln“, lass Esc es freigeben, damit Tab wieder weiterspringt. So bleibt niemand stecken, der die Tastatur nutzt.