Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onbeforeinput — gestire un evento prima della modifica

onbeforeinput è un attributo per la gestione dell’evento beforeinput, relativo alla modifica dei dati da parte dell’utente. Permette di eseguire JavaScript prima di una modifica e di annullare l’operazione predefinita quando l’evento è annullabile.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };

onbeforeinput è un attributo HTML che contiene il codice di gestione dell’evento beforeinput. È disponibile su tutti gli elementi HTML; aggiungerlo non rende di per sé modificabile un elemento. Il suo corrispettivo JavaScript è la proprietà element.onbeforeinput.

Nel codice dell’attributo, event si riferisce all’evento corrente. La chiamata a event.preventDefault() può bloccare l’operazione predefinita solo quando event.cancelable è true. Non dare per scontato che ogni modifica possa essere bloccata in questo modo.

Il valore dell’attributo è codice JavaScript, non il nome di un evento. L’esempio verifica la gestione e l’annullamento di un beforeinput inviato sinteticamente; non simula la digitazione effettiva. Il valore ABC invariato, quindi, non dimostra che la modifica nativa sia stata bloccata.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
  const editor = document.getElementById('editor');
  const event = new Event('beforeinput', { bubbles: true, cancelable: true });
  const allowed = editor.dispatchEvent(event);
  document.getElementById('result').textContent =
    `allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>

Risultato

allowed=false
defaultPrevented=true
value=ABC

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti