CKTIS / HTML
method — Übermittlungsmethode des Formulars
Das Attribut method des Elements form wählt get, post oder dialog. Es bestimmt, wie Formulardaten übermittelt werden, oder schließt einen Dialog, statt eine Netzwerkanfrage zu senden.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<form method="get|post|dialog">…</form>Das Attribut method des Elements form legt fest, wie das Absenden des Formulars behandelt wird. Zulässige Werte sind get, post und dialog. Fehlt das Attribut oder ist sein Wert ungültig, einschließlich einer leeren Zeichenfolge oder put, wird der GET-Zustand gewählt.
Bei HTTP(S)-Zielen fügt get codierte Formulardaten in die URL-Abfrage ein, während post sie im Anfragetext übermittelt. Das Attribut action gibt das Ziel an; enctype bestimmt die Codierung des Anfragetextes bei post.
Der Wert dialog schließt das nächstgelegene übergeordnete Element dialog, ohne Daten über das Netzwerk zu senden. Gibt es kein solches übergeordnetes Element, wird das Absenden nicht ausgeführt. Die Validierung kann diesen Vorgang weiterhin verhindern. Im Beispiel setzt die Schaltfläche den returnValue des Dialogs auf ok.
Ein Attribut formmethod auf der verwendeten Submit-Schaltfläche überschreibt das method des Formulars. Fehlt es, gilt die Einstellung des Formulars; ein ungültiges formmethod wählt GET, statt die Einstellung zu übernehmen.
Beispiele
<!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>Ergebnis
returnValue=ok
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.