Código da tecla Enter
O Enter envia event.key "Enter" e keyCode 13. As duas teclas Enter enviam os mesmos valores; event.code e event.location as diferenciam.
Todos os valores de relance
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Enter / Return | Enter | Enter | 13 | 0 (Padrão) |
| Enter (teclado numérico) | NumpadEnter | Enter | 13 | 3 (Teclado numérico) |
keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.
Pressione aqui
Clique aqui e pressione Enter
Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.
Código para reagir a Enter
document.addEventListener('keydown', (event) => {
if (event.key === 'Enter') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Enter') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 13) {
// Seu código aqui
}
});Qual valor usar
Confira event.key === 'Enter'. É igual para a tecla Enter principal e a do teclado numérico, em todos os layouts, e também nos teclados de celular que enviam um Enter de verdade.
Use event.code só quando as duas teclas precisam fazer coisas diferentes: Enter é a tecla grande e NumpadEnter é a do teclado numérico. A tecla return do Mac é a mesma tecla: ela também envia Enter.
O keyCode 13 ainda chega em todos os navegadores, então o código antigo continua funcionando, mas ele é obsoleto.
O que costuma dar errado
O Enter envia a mensagem enquanto alguém ainda digita em japonês, chinês ou coreano
Com um método de entrada, o Enter primeiro confirma o caractere que está sendo formado. Seu tratador de keydown também vê esse Enter. Ignore-o enquanto um caractere está sendo composto:
if (event.isComposing || event.keyCode === 229) return;
Confira os dois: o Safari envia o Enter de confirmação com isComposing false, mas keyCode 229.
Apertar o Enter num campo de texto envia o formulário
Esse é o envio implícito do navegador. Chame event.preventDefault() no tratador de keydown se o Enter deve fazer outra coisa, ou escute o evento submit do formulário em vez da tecla, que também pega o botão Ir dos teclados de celular.
O tratador roda duas vezes ou muitas vezes
Segurar o Enter repete o keydown. Ignore as repetições com if (event.repeat) return; quando o Enter inicia algo que deve acontecer uma vez só, como enviar uma mensagem.
keypress ou keyup não se comporta como keydown
O keypress é obsoleto e dispara só para teclas que digitam algo. Ele ainda dispara para o Enter, mas não construa nada em cima dele. O keyup vem depois de o navegador já ter enviado o formulário ou adicionado a nova linha, tarde demais para impedir. Use keydown.
O Enter no celular mostra “Ir”, “Avançar” ou “Enviar”
O texto é você quem define: adicione enterkeyhint="send" (ou go, next, search, done) ao campo. Os teclados Android enviam a maioria das teclas como keyCode 229, mas o Enter em geral chega como um Enter de verdade com keyCode 13.
Shift+Enter e Ctrl+Enter
Caixas de chat em geral enviam com o Enter e adicionam uma nova linha com Shift + Enter: confira event.shiftKey. Ctrl + Enter (Cmd + Enter no Mac) é o atalho comum de “enviar mesmo assim”: confira event.ctrlKey || event.metaKey. Num <textarea>, o Enter adiciona uma nova linha, a não ser que você chame preventDefault().