Codice del tasto Bloc Maiusc (Caps Lock)

Caps Lock (Bloc Maiusc) invia event.key "CapsLock", event.code "CapsLock" e keyCode 20.

Tutti i valori in breve

Valori per Bloc Maiusc
Tastoevent.codeevent.keykeyCodeevent.location
Bloc MaiuscCapsLockCapsLock200 (Standard)

Valori di keyCode inviati da Chrome ed Edge su Windows. Le colonne Mac (Chrome e Safari) e Firefox mostrano solo i valori diversi. Alcuni valori cambiano anche in base al sistema, come spiegato qui sotto. event.which ha sempre lo stesso valore di keyCode. Il valore di event.key si riferisce a una tastiera inglese (US) senza Maiusc.

Premilo qui

Fai click qui, poi premi Bloc Maiusc

Usi solo la tastiera? Premi Esc, poi Tab, per uscire dal riquadro.

Codice per reagire a Bloc Maiusc

Consigliato: riconosci event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'CapsLock') {
    // Il tuo codice qui
  }
});
Riconosci il posto del tasto: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'CapsLock') {
    // Il tuo codice qui
  }
});
Vecchio codice che usa ancora keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 20) {
    // Il tuo codice qui
  }
});

Quale valore usare

Per sapere se Bloc Maiusc è attivo, non guardare il tasto. Chiedilo a un qualsiasi evento di tastiera o mouse: event.getModifierState('CapsLock') è true finché è attivo. Funziona anche se Bloc Maiusc è stato acceso prima che la pagina si caricasse.

Per reagire al tasto stesso, controlla event.key === 'CapsLock' (event.code è uguale). keyCode è 20, ma è deprecato.

Bloc Maiusc cambia event.key per le lettere (“A” invece di “a”), ma non event.code né keyCode.

Dove si sbaglia di solito

Il mio avviso “Bloc Maiusc è attivo” è sbagliato

Contare le pressioni di Bloc Maiusc non funziona se era già attivo prima che la pagina si aprisse. Leggi invece lo stato da ogni evento sul campo della password:

function checkCaps(event) {
  warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);

Nascondi l’avviso su blur. Lo stato si conosce solo quando l’utente preme un tasto o muove il mouse: non c’è modo di chiederlo al caricamento della pagina.

Su un Mac, Bloc Maiusc invia un solo evento

Su Windows e Linux, Bloc Maiusc invia keydown e keyup come ogni tasto. Su un Mac, Chrome e Safari inviano solo un keydown quando si accende e solo un keyup quando si spegne. Firefox su un Mac invia solo un keydown ogni volta. Per questo l’avviso qui sopra ascolta entrambi.

Lo stato nell’evento di Bloc Maiusc è vecchio

Nell’evento di Bloc Maiusc, alcuni browser mostrano già il nuovo stato con getModifierState. Altri lo aggiornano più tardi. Controllalo di nuovo al tasto successivo, o in keyup.

Un tocco veloce non lo accende (Mac)

macOS ignora un tocco molto breve su Bloc Maiusc, quindi un tasto sfiorato non lo accende. La tua pagina può vedere l’evento mentre la spia resta spenta. Fidati di getModifierState, non del numero di eventi.

I telefoni non dicono mai che Bloc Maiusc è attivo

Le tastiere sullo schermo hanno il loro blocco maiuscole (tocca due volte Maiusc). Non invia eventi Bloc Maiusc, e getModifierState('CapsLock') resta false. Solo una tastiera fisica lo segnala.

Bloc Maiusc nei giochi e nelle scorciatoie

Non usare Bloc Maiusc come tasto da tenere premuto: su un Mac non ricevi un keyup mentre è premuto. Alcune persone lo rimappano anche su Ctrl o Esc, e allora la pagina riceve quell’altro tasto. Safari su un Mac mostra già il suo simbolo di Bloc Maiusc nei campi password, quindi il tuo avviso può comparire due volte.