Código da tecla Caps Lock
O Caps Lock envia event.key "CapsLock", event.code "CapsLock" e keyCode 20.
Todos os valores de relance
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Caps Lock | CapsLock | CapsLock | 20 | 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 Caps Lock
Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.
Código para reagir a Caps Lock
document.addEventListener('keydown', (event) => {
if (event.key === 'CapsLock') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'CapsLock') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 20) {
// Seu código aqui
}
});Qual valor usar
Para saber se o Caps Lock está ligado, não observe a tecla. Pergunte a qualquer evento de tecla ou de mouse: event.getModifierState('CapsLock') é true enquanto ele está ligado. Isso funciona mesmo que o Caps Lock tenha sido ligado antes de a página carregar.
Para reagir à própria tecla, confira event.key === 'CapsLock' (event.code é igual). O keyCode é 20, mas é obsoleto.
O Caps Lock muda o event.key das letras (“A” em vez de “a”), mas não muda o event.code nem o keyCode.
O que costuma dar errado
Meu aviso de “Caps Lock ligado” está errado
Contar os toques no Caps Lock dá errado se ele já estava ligado antes de a página abrir. Em vez disso, leia o estado de cada evento do campo de senha:
function checkCaps(event) {
warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);
Esconda o aviso no blur. O estado só é conhecido quando a pessoa aperta uma tecla ou mexe o mouse: não há como perguntar quando a página carrega.
No Mac, o Caps Lock envia só um evento
No Windows e no Linux, o Caps Lock envia keydown e keyup como qualquer tecla. No Mac, o Chrome e o Safari enviam só um keydown quando ele liga e só um keyup quando ele desliga. O Firefox no Mac envia só um keydown a cada vez. Por isso o aviso acima escuta os dois.
O estado no evento do próprio Caps Lock está desatualizado
Durante o evento do próprio Caps Lock, os navegadores diferem sobre se o getModifierState já mostra o novo estado. Confira de novo na tecla seguinte, ou no keyup.
Um toque rápido não liga o Caps Lock (Mac)
O macOS ignora um toque muito curto no Caps Lock, então uma tecla roçada não o liga. Sua página pode ver o evento enquanto a luz continua apagada. Confie no getModifierState, não na contagem de eventos.
Celulares nunca dizem que o Caps Lock está ligado
Os teclados na tela têm o próprio caps lock (toque duas vezes no Shift). Ele não envia eventos de Caps Lock, e getModifierState('CapsLock') continua false. Só um teclado físico informa isso.
Caps Lock em jogos e atalhos
Não use o Caps Lock como tecla para segurar: no Mac você não recebe o keyup enquanto ele está apertado. Algumas pessoas também o remapeiam para Ctrl ou Esc, e então a página recebe essa tecla. O Safari no Mac já mostra o próprio símbolo de Caps Lock nos campos de senha, então seu aviso pode aparecer duas vezes ali.