Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti