CKTIS / HTML
onbeforeinput — gestionar un evento antes de la edición
onbeforeinput es un atributo de gestión del evento beforeinput, relacionado con la edición de datos por parte del usuario. Permite ejecutar JavaScript antes de un cambio y cancelar la operación predeterminada cuando el evento se puede cancelar.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };onbeforeinput es un atributo HTML que contiene código de gestión para el evento beforeinput. Está disponible en todos los elementos HTML; añadirlo no hace que un elemento sea editable por sí mismo. Su equivalente en JavaScript es la propiedad element.onbeforeinput.
Dentro del código del atributo, event hace referencia al evento actual. Llamar a event.preventDefault() puede bloquear la operación predeterminada solo cuando event.cancelable es true. No des por hecho que todos los cambios se pueden detener de esta manera.
El valor del atributo es código JavaScript, no el nombre de un evento. El ejemplo comprueba la gestión y cancelación de un beforeinput enviado de forma sintética; no simula la escritura real. Por tanto, que el valor ABC no cambie no demuestra que se haya bloqueado la edición nativa.
Ejemplos
<!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>Resultado
allowed=false defaultPrevented=true value=ABC
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.