Kod klawisza Escape
Esc wysyła event.key "Escape", event.code "Escape" i keyCode 27.
Wszystkie wartości w skrócie
| Klawisz | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Esc | Escape | Escape | 27 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Escape') {
// Twój kod tutaj
}
});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ą.