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.