Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes