KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`submit`- en `input`-events bij HTML-formulieren

Gebruik `input` om op wijzigingen te reageren en `submit` om het verzenden van een formulier op het juiste moment in het validatieproces af te handelen.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();

input ontstaat op het bewerkte formulierelement en bubbelt omhoog door de DOM-boom. In een listener op het formulier verwijst event.target naar het element en event.currentTarget naar het formulier zolang de listener draait. Staat het element buiten het formulier en is het via het attribuut form gekoppeld, dan bereikt het event het formulier niet door die koppeling alleen. Gebruik input voor directe feedback tijdens het bewerken; change markeert een bevestigde wijziging, bij tekstvelden meestal bij het verliezen van de focus. Een toewijzing aan .value veroorzaakt op zichzelf geen input.

submit ontstaat op het formulier, niet op de knop. Het is een SubmitEvent dat omhoog bubbelt en kan worden geannuleerd. Luister hiernaar in plaats van naar click op een knop om ook impliciete verzending af te handelen, bijvoorbeeld met Enter als de browser dat ondersteunt. event.submitter verwijst naar de verzendknop of is null als geen knop de verzending startte. Roep event.preventDefault() in de listener aan vóór elke await om de standaardverzending te voorkomen.

form.requestSubmit() volgt de normale verzendregels zonder een knop te kiezen. form.requestSubmit(button) gebruikt die knop en houdt rekening met diens instellingen, zoals formaction en formnovalidate. Als de validatie van invoervereisten niet wordt overgeslagen en mislukt, krijgen ongeldige velden invalid en wordt er geen submit afgevuurd. Een element dat geen verzendknop is, veroorzaakt een TypeError; een verzendknop die niet bij dit formulier hoort, veroorzaakt een NotFoundError.

Een rechtstreekse aanroep van form.submit() slaat de validatie van invoervereisten over en vuurt geen submit af. Een element met name of id gelijk aan submit kan de methode overschaduwen. Validatie in de browser vervangt validatie op de server niet. Dit zijn API’s van het webplatform, geen functies van ECMAScript 2024; controleer de ondersteuning in de doelomgeving.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement("form");
  const field = document.createElement("input");
  field.type = "text";
  field.required = true;

  const button = document.createElement("button");
  button.type = "submit";
  button.value = "save";
  button.textContent = "Save";
  form.append(field, button);

  field.addEventListener("invalid", (event) => {
    event.preventDefault();
    console.log("invalid");
  });
  form.addEventListener("input", (event) => {
    if (event.target === field) console.log(`input: ${field.value}`);
  });
  form.addEventListener("submit", (event) => {
    event.preventDefault();
    console.log(`submit: ${event.submitter.value}`);
  });

  document.body.append(form);
  try {
    form.requestSubmit(button);
    field.value = "Ada";
    console.log(`set: ${field.value}`);
    field.dispatchEvent(new Event("input", { bubbles: true }));
    form.requestSubmit(button);
  } finally {
    form.remove();
  }
})();
</script>
</body>
</html>

Resultaat

invalid
set: Ada
input: Ada
submit: save

Sla het voorbeeld op als HTML-bestand en open het in een browser. Open de console en laad de pagina opnieuw. Het eerste verzoek logt `invalid`. Na `set: Ada` levert alleen het handmatig afgevuurde event `input: Ada` op; het tweede verzoek logt `submit: save`, maar de listener annuleert de verzending.

Gerelateerde lessen

  • JavaScript · Les 15 · Gevorderd · Versie: 4

Bronnen