Códigos das teclas de pontuação (186–222)
As teclas de pontuação enviam event.code com nomes como "Semicolon" e "Slash" e keyCode 186 a 222, mas os números mudam conforme o navegador e o layout.
Todos os valores de relance
| Tecla | event.code | event.key | keyCode | keyCode no Firefox | event.location |
|---|---|---|---|---|---|
| Ponto e vírgula | Semicolon | ; | 186 | 59 | 0 (Padrão) |
| Igual | Equal | = | 187 | 61 | 0 (Padrão) |
| Vírgula | Comma | , | 188 | 0 (Padrão) | |
| Hífen | Minus | - | 189 | 173 | 0 (Padrão) |
| Ponto | Period | . | 190 | 0 (Padrão) | |
| Barra | Slash | / | 191 | 0 (Padrão) | |
| Acento grave | Backquote | ` | 192 | 0 (Padrão) | |
| Colchete esquerdo | BracketLeft | [ | 219 | 0 (Padrão) | |
| Barra invertida | Backslash | \ | 220 | 0 (Padrão) | |
| Colchete direito | BracketRight | ] | 221 | 0 (Padrão) | |
| Aspas simples | Quote | ' | 222 | 0 (Padrão) |
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 uma tecla de pontuação
Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.
Código para reagir a Ponto e vírgula
document.addEventListener('keydown', (event) => {
if (event.key === ';') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Semicolon') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 186 || event.keyCode === 59) {
// Seu código aqui
}
});Qual valor usar
Para um caractere, como “/” para abrir uma caixa de busca ou “?” para a ajuda, verifique event.key: event.key === '/'. É o que o layout do usuário digita, o mesmo que o usuário vê na tecla.
Para um lugar no teclado, verifique event.code, como BracketLeft e BracketRight para “anterior” e “próximo”. O código é o mesmo em todos os layouts, mesmo onde a tecla digita uma letra.
Evite o keyCode aqui mais do que em qualquer outro lugar. São as teclas em que navegadores e layouts mais discordam.
O que costuma dar errado
O Firefox envia 59, 61 e 173
Para as teclas ; = e -, o Chrome, o Edge e o Safari enviam 186, 187 e 189. O Firefox envia 59, 61 e 173. Código antigo que verifica 187 para aumentar o zoom não faz nada no Firefox. Pior: 173 é a tecla de silenciar no Chrome. Se precisar manter o keyCode, verifique os dois números, mas para o - isso também pega a tecla de silenciar no Chrome. O melhor é verificar event.key.
O número muda em outro layout
Em um teclado alemão QWERTZ, a tecla à direita do L digita “ö”, e o keyCode dela é 192 no Chrome do Windows, e não 186. Em um teclado japonês, a mesma tecla digita “;” mas envia 187. Compare caracteres por event.key e lugares por event.code.
Um atalho de “/” ou “?” não dispara
Em muitos layouts, esses caracteres precisam do Shift: “/” é Shift + 7 em um teclado alemão. No ABNT2 brasileiro, “/” e “?” ficam numa tecla própria ao lado do Shift direito, com event.code “IntlRo” e keyCode 193. Uma verificação de event.code === 'Slash' ou de keyCode 191 não os pega. Verifique event.key === '/' ou event.key === '?', e não acrescente event.shiftKey para “?”: o Shift já faz parte de como o usuário o digita.
A tecla envia “Dead”
Muitos layouts têm teclas mortas: elas esperam a próxima tecla para acrescentar um acento. O ´, o ~ e o ^ do ABNT2, o ^ e o ´ alemães, o ^ francês e as teclas ' e ` do US Internacional enviam event.key “Dead”, e a próxima tecla recebe a letra acentuada. Um atalho de console na tecla ` nunca vê esse caractere nesses layouts. Compare esses atalhos por event.code (Backquote).
Uma tecla extra ao lado do Shift esquerdo
Teclados europeus (ISO) têm mais uma tecla entre o Shift esquerdo e o Z. O código dela é IntlBackslash, e ela não está na tabela acima. Ela digita “<” em um teclado alemão e “\” em um britânico. O keyCode depende do layout (muitas vezes 226 no Windows), então compare por event.key ou event.code.