KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

formmethod — verzendmethode voor een knop

Het attribuut formmethod kiest de verzendmethode van het formulier voor een specifieke verzendknop. Het accepteert get, post en dialog en overschrijft method van het formulier wanneer die knop de verzending start.

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

Syntax

formmethod="get|post|dialog"

formmethod geldt voor verzendknoppen: button-elementen die als verzendknop werken en input-elementen met type="submit" of type="image". Een button kan ook zonder het attribuut type als verzendknop werken; type="submit" hoeft niet expliciet te worden opgegeven. Het attribuut formmethod heeft invloed op een verzending die door die knop wordt gestart, zonder het attribuut method van het formulier te wijzigen.

get verstuurt gegevens in de URL, terwijl post ze in de HTTP-aanvraagbody verstuurt. dialog sluit het bovenliggende dialog-element van het formulier in plaats van gegevens te verzenden; zonder zo’n bovenliggend element vindt er geen verzending plaats.

Als formmethod ontbreekt, wordt method van het gekoppelde formulier gebruikt. Een ongeldige waarde, ook een lege tekenreeks, kiest in plaats daarvan get en niet de methode van het formulier. Als het formulier zelf geen method heeft, is de standaardwaarde get.

In het voorbeeld overschrijft formmethod="dialog" method="post". Als je op Close klikt, wordt het dialoogvenster gesloten zonder formulieraanvraag en wordt de returnValue ervan ingesteld op done, de waarde van de knop.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>formmethod</title>
<dialog id="demo">
  <form method="post">
    <button type="submit" formmethod="dialog" value="done">Close</button>
  </form>
</dialog>
<output id="result">waiting</output>
<script>
  const demo = document.getElementById('demo');
  const result = document.getElementById('result');
  demo.addEventListener('close', () => {
    result.textContent = demo.returnValue;
  });
  demo.showModal();
</script>

Resultaat

done

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