KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

form — HTML-formulier

Het form-element koppelt bedieningselementen aan een formulier en bepaalt hoe hun gegevens worden verzonden. Het ondersteunt native verzending en validatie; JavaScript kan de verzending onderscheppen.

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

Syntax

<form action="/search" method="get">…</form>

form vertegenwoordigt een formulier waarvan de bedieningselementen gegevens kunnen leveren voor verwerking. Zowel de openingstag als de sluitingstag is vereist; formulieren mogen niet in elkaar worden genest. Ondersteunde bedieningselementen buiten het formulier kunnen eraan worden gekoppeld met een form-attribuut dat naar de id ervan verwijst.

action geeft de bestemming aan. method="get" (de standaardwaarde) zet gegevens in de URL-query, terwijl method="post" ze in de aanvraagbody zet. Gebruik voor bestandsuploads met POST enctype="multipart/form-data". POST alleen biedt geen versleuteling.

Gegevenssleutels komen uit name, niet uit id. Uitgeschakelde bedieningselementen en niet-aangevinkte selectievakjes worden weggelaten. Bedieningselementen zonder naam worden meestal weggelaten, maar een grafische verzendknop (<input type="image">) zonder naam waarmee het formulier wordt verzonden, voegt coördinaten met de sleutels x en y toe. Koppel labels aan velden. Browservalidatie helpt gebruikers, maar vervangt servervalidatie niet.

Bij een normale verzending vindt interactieve validatie plaats voordat de gebeurtenis submit wordt geactiveerd, tenzij de validatie wordt overgeslagen. Als de validatie mislukt, stopt de verzending en wordt de gebeurtenis submit niet geactiveerd. Met het attribuut novalidate wordt interactieve validatie overgeslagen. Gebruik in scripts bij voorkeur requestSubmit(): anders dan submit() behoudt dit de validatie en de gebeurtenis submit.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML form example</title>
</head>
<body>
  <form id="search" method="get">
    <label for="query">Query</label>
    <input id="query" name="q" value="html" required>
    <button id="submit-query" type="submit">Submit query</button>
  </form>
  <output id="result" for="query" aria-live="polite"></output>
  <script>
    const form = document.getElementById('search');
    const submitButton = document.getElementById('submit-query');
    const result = document.getElementById('result');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      const data = new FormData(form);
      result.value = 'q=' + data.get('q');
      console.log(result.value);
    });

    form.requestSubmit(submitButton);
  </script>
</body>
</html>

Resultaat

q=html

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