CKTIS / JavaScript
Campi di KeyboardEvent: significato, posizione e stato dei tasti
Distingui il valore di un tasto dalla sua posizione fisica e controlla ripetizione, stato di Shift e composizione del testo. Questi campi di KeyboardEvent aiutano a gestire le scorciatoie senza confondere il layout della tastiera con il testo inserito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent descrive eventi della tastiera come keydown e keyup. Le cinque proprietà descritte qui (key, code, repeat, shiftKey e isComposing) sono di sola lettura, ma alcune proprietà ereditate da Event, come cancelBubble, sono scrivibili. KeyboardEvent.key è una stringa che indica il significato del tasto tenendo conto del layout e dei modificatori, per esempio "z", "Z" o "Enter". KeyboardEvent.code è una stringa che identifica la posizione fisica del tasto indipendentemente dal layout: su una tastiera QWERTZ, "KeyY" può accompagnare key: "Z". Usa key per il significato del tasto e code per i controlli basati sulla posizione.
KeyboardEvent.repeat è un valore booleano: true indica la ripetizione automatica di un tasto tenuto premuto, non un conteggio delle ripetizioni. In un gestore keydown, if (event.repeat) return; può ignorare le azioni ripetute. KeyboardEvent.shiftKey indica se Shift era attivo quando si è verificato l’evento; non significa che l’evento riguardi Shift stesso. Quando si preme un tasto Shift (keydown), il valore è true; quando lo si rilascia (keyup), può restare true se l’altro tasto Shift è ancora premuto.
KeyboardEvent.isComposing è un valore booleano che indica un evento tra compositionstart e compositionend, per esempio durante la composizione del testo tramite IME. Ignorare le scorciatoie quando vale true riduce le interferenze con la composizione, ma non rileva tutti i casi limite delle IME: può valere false all’inizio o alla fine della composizione. Gli eventi della tastiera non sostituiscono l’evento input per tenere traccia delle modifiche al testo.
Queste sono Web API del browser, non funzionalità di una specifica edizione di ECMAScript; Node 24 nel repository non ne dimostra la disponibilità. Verifica la compatibilità di ogni proprietà con i browser di destinazione; MDN contrassegna repeat come Baseline 2025, ma ciò non garantisce il supporto nelle versioni precedenti. L’esempio crea un evento sintetico con valori espliciti: verifica l’accesso ai campi, non le pressioni reali dei tasti né il comportamento di una IME.
Esempi
(() => {
const event = new KeyboardEvent("keydown", {
key: "Z",
code: "KeyY",
repeat: true,
shiftKey: true,
isComposing: false
});
const { key, code, repeat, shiftKey, isComposing } = event;
console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();Risultato
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.