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

Valores de Teclas de pontuação
Teclaevent.codeevent.keykeyCodekeyCode no Firefoxevent.location
Ponto e vírgulaSemicolon;186590 (Padrão)
IgualEqual=187610 (Padrão)
VírgulaComma,1880 (Padrão)
HífenMinus-1891730 (Padrão)
PontoPeriod.1900 (Padrão)
BarraSlash/1910 (Padrão)
Acento graveBackquote`1920 (Padrão)
Colchete esquerdoBracketLeft[2190 (Padrão)
Barra invertidaBackslash\2200 (Padrão)
Colchete direitoBracketRight]2210 (Padrão)
Aspas simplesQuote'2220 (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

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === ';') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Semicolon') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
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.