Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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-only

key 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

Fonti