CKTIS / JavaScript
KeyboardEvent: valore del tasto e ripetizione automatica
Usa `key` per identificare il valore del tasto e `repeat` per distinguere la pressione iniziale dalle ripetizioni automatiche quando il tasto resta premuto.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key è una proprietà di sola lettura che restituisce una stringa come "Enter", "a" o "A". Il valore dipende dalla disposizione della tastiera e dai modificatori attivi, come Shift. A differenza di code, che identifica la posizione fisica del tasto, key può cambiare tra un evento e l’altro se cambia lo stato di un modificatore.
KeyboardEvent.repeat è una proprietà booleana di sola lettura. Negli eventi keydown reali vale false alla pressione iniziale e true negli eventi successivi generati dalla ripetizione automatica. Non indica se un tasto è premuto in quel momento. Non tutti i tasti si ripetono e la frequenza di ripetizione dipende dall’ambiente.
Per eseguire un’azione una sola volta per ogni pressione di Invio, verifica event.key === "Enter" && !event.repeat nel gestore di keydown. Se l’azione deve ripetersi mentre il tasto resta premuto, non filtrare gli eventi in base a repeat.
KeyboardEvent è un’API della piattaforma web e non fa parte di ECMAScript 2024. Non dare per scontato che esista in ogni ambiente di esecuzione JavaScript: verifica il supporto nell’ambiente di destinazione.
Esempi
{
function handleKeydown(event) {
if (event.key !== "Enter" || event.repeat) return;
console.log("activate");
}
handleKeydown({ key: "Enter", repeat: false });
handleKeydown({ key: "Enter", repeat: true });
handleKeydown({ key: "Escape", repeat: false });
}Risultato
activate
Esegui il codice in Node.js o nella console del browser. Il gestore riceve direttamente tre semplici oggetti con le proprietà `key` e `repeat` anziché eventi di tastiera. Stampa `activate` solo per il primo oggetto: la prova riguarda la condizione, non la frequenza di ripetizione.
Lezioni correlate
- JavaScript · Lezione 34 · Intermedio · Versione: 3
- JavaScript · Lezione 35 · Intermedio · Versione: 3
- JavaScript · Lezione 38 · Intermedio · Versione: 3