Kod klawisza Enter
Enter wysyła event.key "Enter" i keyCode 13. Oba klawisze Enter mają te same wartości; odróżnisz je po event.code i event.location.
Wszystkie wartości w skrócie
| Klawisz | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Enter / Return | Enter | Enter | 13 | 0 (Zwykły) |
| Num Enter | NumpadEnter | Enter | 13 | 3 (Klawiatura numeryczna) |
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 Enter
Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.
Kod, który reaguje na klawisz: Enter
document.addEventListener('keydown', (event) => {
if (event.key === 'Enter') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Enter') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 13) {
// Twój kod tutaj
}
});Której wartości użyć
Sprawdzaj event.key === 'Enter'. Ta wartość jest taka sama dla głównego Enter i dla Enter na klawiaturze numerycznej, na każdym układzie, a także na klawiaturach telefonów, które wysyłają prawdziwy Enter.
Użyj event.code tylko wtedy, gdy oba klawisze mają robić co innego: Enter to duży klawisz, a NumpadEnter to ten na klawiaturze numerycznej. Klawisz return na Macu to ten sam klawisz: też wysyła Enter.
keyCode 13 nadal dociera w każdej przeglądarce, więc stary kod nadal działa, ale sam keyCode jest wycofywany.
Co sprawia kłopoty
Enter wysyła wiadomość, gdy ktoś jeszcze pisze po japońsku, chińsku lub koreańsku
Przy metodzie wprowadzania (IME) Enter najpierw zatwierdza składany znak. Twoja obsługa keydown też dostaje to zdarzenie Enter. Pomiń je, jeśli trwa składanie znaku:
if (event.isComposing || event.keyCode === 229) return;
Sprawdź oba warunki: Safari wysyła zatwierdzający Enter z isComposing równym false, ale z keyCode 229.
Enter w polu tekstowym wysyła formularz
To niejawne wysyłanie formularza przez przeglądarkę. Wywołaj event.preventDefault() w obsłudze keydown, jeśli Enter ma robić coś innego, albo zamiast klawisza nasłuchuj zdarzenia submit formularza: obejmuje ono też przycisk „Przejdź” na klawiaturach telefonów.
Obsługa uruchamia się dwa razy lub wiele razy
Przytrzymanie Enter powtarza keydown. Ignoruj powtórzenia przez if (event.repeat) return;, gdy Enter uruchamia coś, co ma się zdarzyć raz, na przykład wysłanie wiadomości.
keypress lub keyup nie zachowują się jak keydown
keypress jest wycofywany i zachodzi tylko dla klawiszy, które coś wpisują. Nadal działa dla Enter, ale nie opieraj na nim niczego. keyup przychodzi, gdy przeglądarka już wysłała formularz lub dodała nowy wiersz, czyli za późno, aby to zatrzymać. Użyj keydown.
Enter w telefonie pokazuje „Przejdź”, „Dalej” lub „Wyślij”
Napis na klawiszu zależy od ciebie: dodaj enterkeyhint="send" (albo go, next, search, done) do pola. Klawiatury Androida wysyłają większość klawiszy jako keyCode 229, ale Enter zwykle przychodzi jako prawdziwy Enter z keyCode 13.
Shift+Enter i Ctrl+Enter
Pola czatu zwykle wysyłają wiadomość po Enter, a Shift + Enter dodaje nowy wiersz: sprawdź event.shiftKey. Ctrl + Enter (Cmd + Enter na Macu) to częsty skrót „wyślij mimo to”: sprawdź event.ctrlKey || event.metaKey. W <textarea> Enter dodaje nowy wiersz, chyba że wywołasz preventDefault().