Kod klawisza Escape

Esc wysyła event.key "Escape", event.code "Escape" i keyCode 27.

Wszystkie wartości w skrócie

Escape – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
EscEscapeEscape270 (Zwykły)

keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.

Naciśnij go tutaj

Kliknij tutaj, a potem naciśnij Escape

Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.

Kod, który reaguje na klawisz: Escape

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Escape') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Escape') {
    // Twój kod tutaj
  }
});
Stary kod, który nadal używa keyCode (jego używanie nie jest już zalecane)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 27) {
    // Twój kod tutaj
  }
});

Której wartości użyć

Sprawdzaj event.key === 'Escape'. Jest tylko jeden klawisz Esc i na każdym układzie wysyła tę samą wartość, więc event.key i event.code mówią tu to samo. key czyta się lepiej.

keyCode 27 nadal dociera w każdej przeglądarce, ale jest wycofywany.

Bardzo stare przeglądarki wysyłały zamiast tego "Esc": Internet Explorer i Firefox 36 i starsze. Akceptuj obie wartości tylko wtedy, gdy nadal je obsługujesz.

Co sprawia kłopoty

Esc zamyka tryb pełnoekranowy mimo obsługi zdarzenia

W trybie pełnoekranowym (i przy zablokowanym wskaźniku) Esc należy do przeglądarki. Naciśnięcie Esc kończy tryb pełnoekranowy lub zwalnia blokadę wskaźnika. preventDefault() tego nie powstrzyma, a funkcja obsługująca klawiaturę może w ogóle nie otrzymać zdarzenia. Nasłuchuj fullscreenchange, aby wiedzieć, że to się stało. W Chromium gra może w trybie pełnoekranowym wywołać navigator.keyboard.lock(['Escape']). Wtedy użytkownik musi przytrzymać Esc, aby wyjść.

Okno dialogowe zamyka się mimo anulowania zdarzenia

Modalny element <dialog> sam zamyka się po Esc. Najpierw wywołuje zdarzenie cancel, które możesz zatrzymać:

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

Chrome pozwala zapobiec zamknięciu okna tylko za pierwszym razem: naciśnij Esc ponownie, nie klikając niczego po drodze, a okno i tak się zamknie. Jeśli okno ma celowo pozostać otwarte, ustaw closedby="none" tam, gdzie jest to obsługiwane, i zapisuj pracę użytkownika po zdarzeniu close. Nie polegaj na zdarzeniu cancel.

Esc zamyka dwie rzeczy naraz

Gdy w oknie dialogowym otwarte jest menu, oba elementy reagują na to samo naciśnięcie Esc. Zamknij tylko menu: obsłuż Esc w menu, potem wywołaj event.stopPropagation(), żeby kod okna się nie uruchomił, i event.preventDefault(), żeby natywny element <dialog> też się nie zamknął: jego zamknięcie to domyślna akcja przeglądarki, a nie obsługa zdarzenia.

Esc w polu wyszukiwania czyści je

W Chrome i niektórych innych przeglądarkach Esc opróżnia <input type="search">. Jeśli Esc ma zamykać twoje pole wyszukiwania, wywołaj preventDefault() w keydown albo wyczyść i zamknij w jednym kroku.

Klawiatura iPada nie ma klawisza Esc

Niektóre klawiatury iPada nie mają Esc, a telefony nigdy go nie mają. Zawsze dodaj też widoczny przycisk zamknięcia. Esc to skrót, a nie jedyna droga wyjścia.

Esc jako droga wyjścia

Użytkownicy klawiatury oczekują, że Esc zamknie menu, wyskakujące okna i okna dialogowe oraz odda fokus przyciskowi, który je otworzył. Jeśli element przechwytuje każdy klawisz, jak edytor kodu albo pole w naszym narzędziu do sprawdzania kodów klawiszy, po naciśnięciu Esc zakończ przechwytywanie klawiszy, aby Tab znów przenosił fokus do kolejnego elementu. Dzięki temu użytkownicy klawiatury nie utkną.