Codice del tasto Ctrl

Entrambi i tasti Ctrl inviano event.key "Control" e keyCode 17. Solo event.code ed event.location distinguono sinistro e destro.

Tutti i valori in breve

Valori per Ctrl
Tastoevent.codeevent.keykeyCodeevent.location
Ctrl sinistroControlLeftControl171 (Lato sinistro)
Ctrl destroControlRightControl172 (Lato destro)

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 Ctrl

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

Codice per reagire a Ctrl sinistro

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

Quale valore usare

Per le scorciatoie, controlla event.ctrlKey nel keydown dell’altro tasto. È true finché tieni premuto uno dei due tasti Ctrl, quindi non devi tenere traccia tu di Ctrl.

Per reagire a Ctrl stesso, controlla event.key === 'Control'. Lo inviano entrambi i tasti, con keyCode 17. Usa event.code (ControlLeft o ControlRight) o event.location (1 sinistro, 2 destro) per distinguerli. Molti portatili non hanno affatto il Ctrl destro.

Su un Mac, il tasto Ctrl invia gli stessi valori. Su alcune tastiere trovi la scritta “control”. Ma le scorciatoie del Mac usano Comando, cioè metaKey, non ctrlKey.

Dove si sbaglia di solito

La scorciatoia funziona su Windows ma non su un Mac

Gli utenti Mac premono Comando + S, non Ctrl + S. Accetta entrambi:

if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
  event.preventDefault();
  save();
}

Mostra anche l’etichetta giusta: Ctrl + S su Windows e Linux, Comando + S o ⌘S su un Mac.

Ctrl scatta quando l’utente scrive @ o € con Alt Gr

Su Windows, Alt Gr funziona come Ctrl e Alt insieme. Chrome ed Edge inviano prima un keydown di Ctrl sinistro, poi Alt destro, e ctrlKey e altKey sono entrambi true quando premi il tasto della lettera. Una scorciatoia come Ctrl + Alt + ò può quindi scattare mentre scrivi “@” con Alt Gr + ò su una tastiera italiana. Evita le scorciatoie Ctrl + Alt, oppure salta i tasti il cui event.key è un carattere diverso dalla lettera che ti aspetti.

Ctrl+W, Ctrl+T, Ctrl+N o Ctrl+Tab non si possono fermare

Li tiene il browser: Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Pag su e Ctrl + Pag giù su Windows. In Chrome ed Edge la pagina non riceve nessun keydown; Firefox può inviare il keydown, ma preventDefault() non blocca queste scorciatoie del browser. Scegli altre scorciatoie. Ctrl + S, Ctrl + P e Ctrl + F arrivano, e preventDefault() ferma l’azione del browser.

Ctrl+click apre un menu su un Mac

Su un Mac, Ctrl + click è un click destro: il browser invia contextmenu. Non usare Ctrl + click per “aggiungi alla selezione” su un Mac; lì usa Comando + click (metaKey), come fanno le app del Mac.

Ctrl+rotella fa lo zoom della pagina

Per fare zoom, tieni premuto Ctrl e usa la rotella del mouse. Sul touchpad puoi avvicinare o allontanare due dita. Chrome, Edge e Firefox inviano questo gesto come evento wheel con Ctrl. Un listener wheel vede ctrlKey true; chiama preventDefault() solo se la tua mappa o il tuo canvas fa uno zoom suo, e registralo con { passive: false }.