CKTIS / HTML
method — verzendmethode van het formulier
Het attribuut method van het element form kiest get, post of dialog. Het bepaalt hoe formuliergegevens worden verzonden, of sluit een dialoogvenster in plaats van een netwerkverzoek te doen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<form method="get|post|dialog">…</form>Het attribuut method van het element form bepaalt hoe het verzenden van het formulier wordt afgehandeld. De toegestane waarden zijn get, post en dialog. Als het attribuut ontbreekt of een ongeldige waarde heeft, waaronder een lege tekenreeks of put, wordt de GET-toestand gekozen.
Bij HTTP(S)-bestemmingen plaatst get gecodeerde formuliergegevens in de URL-query, terwijl post ze in de hoofdtekst van het verzoek verzendt. Het attribuut action geeft de bestemming op; enctype bepaalt de codering van de hoofdtekst bij post.
De waarde dialog sluit het dichtstbijzijnde bovenliggende element dialog zonder gegevens via het netwerk te verzenden. Zonder zo’n bovenliggend element wordt het verzenden niet uitgevoerd. Validatie kan deze handeling nog steeds blokkeren. In het voorbeeld stelt de knop de returnValue van het dialoogvenster in op ok.
Een attribuut formmethod op de gebruikte verzendknop overschrijft het method van het formulier. Als het ontbreekt, geldt de instelling van het formulier; een ongeldig formmethod kiest GET in plaats van de instelling over te nemen.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>method demo</title>
<dialog id="choice">
<form method="dialog">
<button type="submit" value="ok">OK</button>
</form>
</dialog>
<pre id="result">waiting</pre>
<script>
const choice = document.getElementById('choice');
const result = document.getElementById('result');
choice.addEventListener('close', () => {
result.textContent = `returnValue=${choice.returnValue}`;
});
choice.showModal();
</script>
</html>Resultaat
returnValue=ok
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.