Codice della barra spaziatrice

La barra spaziatrice invia event.key " " (un solo spazio), event.code "Space" e keyCode 32.

Tutti i valori in breve

Valori per Barra spaziatrice
Tastoevent.codeevent.keykeyCodeevent.location
SpazioSpace" "320 (Standard)

Valori di keyCode inviati da Chrome ed Edge su Windows. Le colonne Mac (Chrome e Safari) e Firefox mostrano solo i valori diversi. Alcuni valori cambiano anche in base al sistema, come spiegato qui sotto. event.which ha sempre lo stesso valore di keyCode. Il valore di event.key si riferisce a una tastiera inglese (US) senza Maiusc.

Premilo qui

Fai click qui, poi premi Barra spaziatrice

Usi solo la tastiera? Premi Esc, poi Tab, per uscire dal riquadro.

Codice per reagire a Barra spaziatrice

Consigliato: riconosci event.key
document.addEventListener('keydown', (event) => {
  if (event.key === ' ') {
    // Il tuo codice qui
  }
});
Riconosci il posto del tasto: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Space') {
    // Il tuo codice qui
  }
});
Vecchio codice che usa ancora keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 32) {
    // Il tuo codice qui
  }
});

Quale valore usare

Controlla event.key === ' ', una stringa con dentro uno spazio. event.key === 'Space' non è mai true: key contiene ciò che il tasto scrive, e la barra spaziatrice scrive uno spazio.

event.code === 'Space' indica il tasto stesso. Usalo per giochi e scorciatoie, dove conta la posizione del tasto. È uguale con ogni layout.

keyCode è 32 in ogni browser, come il codice del carattere spazio, ma è deprecato. Internet Explorer e Firefox 36 e precedenti inviavano "Spacebar" come key: accettalo solo se li supporti ancora.

Dove si sbaglia di solito

Premere Spazio fa scorrere la pagina

Spazio scorre in basso di una schermata e Maiusc + Spazio scorre in alto, quando nessun elemento con il focus lo usa. Fermalo nel keydown, dove inizia lo scorrimento. Lascia stare i campi di testo, o nessuno riesce a scrivere uno spazio:

if (event.code === 'Space' && !event.target.closest('input, textarea, [contenteditable]')) {
  event.preventDefault();
}

Spazio preme il pulsante che ha ancora il focus

Dopo che qualcuno ha fatto click su un pulsante, quello mantiene il focus e Spazio lo preme di nuovo. Se usi Spazio per saltare in un gioco, puoi anche far ripartire il gioco o metterlo in pausa per sbaglio. Sposta il focus altrove (button.blur()) oppure chiama preventDefault() su Spazio mentre il gioco è in corso.

Il pulsante scatta al keyup, non al keydown

I pulsanti reagiscono a Invio appena lo premi, ma a Spazio solo quando lo rilasci. Tenere premuto Spazio non ripete il click. Se un tuo elemento role="button" gestisce i tasti, copia questo comportamento: Invio al keydown, Spazio al keyup.

Spazio sceglie una parola scrivendo in giapponese o cinese

Con un metodo di input, Spazio converte i suoni scritti in caratteri. Il tuo gestore lo vede con isComposing true o keyCode 229. Salta questi casi:

if (event.isComposing || event.keyCode === 229) return;

Il gestore vede key “ “ ma il testo non mostra nulla

È normale: il valore è davvero un solo spazio, quindi sembra vuoto quando lo stampi. Stampa JSON.stringify(event.key) nella console per vedere " ".

Spazio sugli smartphone

Le tastiere Android spesso inviano keyCode 229 e key "Unidentified" per la barra spaziatrice, come per la maggior parte dei tasti. Per reagire a uno spazio scritto in un campo, leggi invece event.data === ' ' dall’evento input.