CKTIS / JavaScript
KeyboardEvent: valore del tasto e stato di Maiusc
`key` indica il valore del tasto, mentre `shiftKey` indica se Maiusc era attivo al momento dell’evento. Usa entrambe le proprietà per distinguere Invio da Maiusc+Invio.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
event.key // string, read-only
event.shiftKey // boolean, read-onlykey e shiftKey sono due proprietà di sola lettura di un’istanza di KeyboardEvent. event.key è una stringa: contiene la rappresentazione testuale di un tasto stampabile o un valore predefinito, come "Enter", per un tasto speciale. Negli eventi generati dal browser, la disposizione della tastiera e i modificatori attivi influiscono su key. Se conta la posizione fisica del tasto, usa invece event.code.
event.shiftKey è un booleano: true se Maiusc era attivo al momento dell’evento, altrimenti false. Descrive quell’evento, non lo stato attuale della tastiera. Non confondere event.key === "Shift", che identifica il tasto Maiusc stesso, con event.shiftKey, che può valere true anche per un altro tasto.
In un gestore di keydown, event.key === "Enter" && event.shiftKey rileva Invio con Maiusc attivo. La condizione non esclude altri modificatori. KeyboardEvent è un’API Web, non fa parte di ECMAScript 2024; la sua disponibilità dipende dall’ambiente di esecuzione.
Esempi
{
const eventInits = [
{ key: "Enter" },
{ key: "Enter", shiftKey: true },
];
// Without KeyboardEvent, use plain objects to model just these two properties.
const events = eventInits.map((init) =>
typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", init)
: { key: init.key, shiftKey: init.shiftKey ?? false }
);
for (const event of events) {
const isShiftEnter = event.key === "Enter" && event.shiftKey;
console.log(`${event.key} | shiftKey=${event.shiftKey} | match=${isShiftEnter}`);
}
}Risultato
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Esegui il codice nella console per sviluppatori del browser o come script in Node.js. Nel browser crea due eventi sintetici `KeyboardEvent` senza inviarli. Se il costruttore non è disponibile, usa oggetti semplici che riproducono solo `key` e `shiftKey`. In entrambi gli oggetti, `key` vale `"Enter"`. Nel primo si omette `shiftKey` nelle opzioni, quindi vale `false`; nel secondo è impostato a `true`. Solo il secondo oggetto soddisfa la condizione.
Lezioni correlate
- JavaScript · Lezione 40 · Intermedio · Versione: 3