KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Formulieren en geldigheid

Gebruik `input` om te reageren op wijzigingen in een veld en `submit` om de verzending van een formulier af te handelen nadat de normale validatie is geslaagd. `HTMLFormElement` biedt ook methoden om de geldigheid van het formulier expliciet te controleren.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();

HTMLFormElement is de DOM-interface van de browser voor een form-element. Via de eigenschap form.elements heb je toegang tot de besturingselementen die bij het formulier horen. Dit is een web-API en geen onderdeel van de taal ECMAScript.

Luister naar de gebeurtenis input om te reageren op wijzigingen door de gebruiker, bijvoorbeeld om tijdens het typen een aanwijzing bij te werken. Als je in JavaScript een waarde aan field.value toewijst, wordt input niet vanzelf geactiveerd. Het attribuut required maakt een leeg tekstveld ongeldig. form.checkValidity() geeft het resultaat terug als een booleaanse waarde. form.reportValidity() geeft ook een booleaanse waarde terug en toont validatiefouten aan de gebruiker, tenzij de gebeurtenis invalid van het betreffende besturingselement wordt geannuleerd. Het annuleren van die gebeurtenis verandert het validatieresultaat niet: de methode geeft false terug zonder een foutmelding voor dat besturingselement te tonen.

Bij een normale verzendpoging controleert de browser eerst de geldigheidsvoorwaarden. Als een veld ongeldig is, blokkeert de browser de verzending en treedt de gebeurtenis submit niet op. Slaagt de validatie, dan treedt submit op bij het formulier, niet bij de knop. Door in de gebeurtenishandler event.preventDefault() aan te roepen, annuleer je de standaardverzending.

Gebruik form.requestSubmit() om hetzelfde proces vanuit je code te starten. Als je form.submit() rechtstreeks aanroept, sla je zowel de validatie als de gebeurtenis submit over. Validatie in de browser helpt gebruikers hun invoer te corrigeren, maar vervangt de validatie op de server niet.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
  <label>Name <input name="displayName" required></label>
  <button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.querySelector('#profile');
  const field = form.elements.namedItem('displayName');
  const log = document.querySelector('#log');
  const append = (line) => { log.textContent += line + '\n'; };

  field.addEventListener('input', () => {
    append(`input: ${form.checkValidity()}`);
  });
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    append(`submit: ${field.value}`);
  });

  append(`initial: ${form.checkValidity()}`);
</script>

Resultaat

initial: false
input: true
submit: A

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