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

Enter – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
Enter / ReturnEnterEnter130 (Zwykły)
Num EnterNumpadEnterEnter133 (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

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Enter') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Enter') {
    // 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 === 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().