KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onbeforeinput — een gebeurtenis vóór het bewerken afhandelen

onbeforeinput is een gebeurtenisafhandelingsattribuut voor beforeinput, dat te maken heeft met het bewerken van gegevens door de gebruiker. Hiermee kan JavaScript vóór een wijziging worden uitgevoerd en kan de standaardbewerking worden geannuleerd als de gebeurtenis annuleerbaar is.

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

Syntax

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

onbeforeinput is een HTML-attribuut met afhandelingscode voor de gebeurtenis beforeinput. Het is beschikbaar op alle HTML-elementen; door het toe te voegen wordt een element niet vanzelf bewerkbaar. Het JavaScript-equivalent is de eigenschap element.onbeforeinput.

In de attribuutcode verwijst event naar de huidige gebeurtenis. Met event.preventDefault() kan de standaardbewerking alleen worden geblokkeerd wanneer event.cancelable de waarde true heeft. Ga er niet van uit dat elke wijziging op deze manier kan worden tegengehouden.

De attribuutwaarde is JavaScript-code, geen gebeurtenisnaam. Het voorbeeld controleert de afhandeling en annulering van een synthetisch verzonden beforeinput; het simuleert geen daadwerkelijk typen. De ongewijzigde waarde ABC bewijst daarom niet dat de native bewerking is geblokkeerd.

Voorbeelden

<!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>

Resultaat

allowed=false
defaultPrevented=true
value=ABC

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen