CKTIS / HTML
formmethod — Übermittlungsmethode für eine Schaltfläche
Das Attribut formmethod legt die Übermittlungsmethode für eine bestimmte Submit-Schaltfläche fest. Es akzeptiert get, post und dialog und überschreibt bei einer durch diese Schaltfläche ausgelösten Übermittlung das method-Attribut des Formulars.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
formmethod="get|post|dialog"formmethod gilt für Submit-Schaltflächen: für button-Elemente, die als solche dienen, und für input-Elemente mit type="submit" oder type="image". Ein button kann auch ohne das Attribut type als Submit-Schaltfläche dienen; die ausdrückliche Angabe type="submit" ist nicht erforderlich. Das Attribut wirkt sich auf eine durch diese Schaltfläche ausgelöste Übermittlung aus, ohne das method-Attribut des Formulars zu ändern.
get sendet Daten in der URL, während post sie im HTTP-Anfragetext sendet. dialog schließt das übergeordnete dialog-Element des Formulars, statt Daten zu senden; ohne ein solches übergeordnetes Element findet keine Übermittlung statt.
Wenn formmethod fehlt, wird method des zugehörigen Formulars verwendet. Ein ungültiger Wert, auch eine leere Zeichenfolge, wählt stattdessen get und nicht die Methode des Formulars. Hat das Formular selbst kein method, ist get die Standardeinstellung.
Im Beispiel überschreibt formmethod="dialog" das Attribut method="post". Ein Klick auf Close schließt den Dialog ohne Formularanfrage und setzt dessen returnValue auf done, den Wert der Schaltfläche.
Beispiele
<!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>Ergebnis
done
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.