CKTIS / HTML
formaction — Übermittlungs-URL für einen Button
Das Attribut formaction überschreibt die action eines Formulars, wenn ein bestimmter Button die Übermittlung auslöst. So kann dasselbe Formular an unterschiedliche URLs gesendet werden, ohne das Standardziel des Formulars zu ändern.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction legt die Übermittlungs-URL für einen bestimmten Submit-Button fest: für ein absendendes button oder ein input mit type="submit" oder type="image". Es darf nicht auf einem gewöhnlichen Button oder einem Reset-Button verwendet werden.
Hat der absendende Button ein formaction, überschreibt dessen Wert bei dieser Übermittlung die action des zugehörigen Formulars. Ohne dieses Attribut gilt die action des Formulars. Der Wert muss eine gültige, nicht leere URL sein; eine relative URL ist zulässig.
Das Attribut ändert das Ziel, nicht die HTTP-Methode, die Kodierung oder die Validierungsregeln. Im Beispiel hat das Formular kein method-Attribut, daher ist GET die Standardmethode. Der Handler für das submit-Ereignis verhindert die Übermittlung und gibt in der Konsole nur die Buttonbeschriftung und das Fragment der ausgewählten URL aus: #publish für Publish und #preview für Preview. Das Beispiel sendet keine GET-Anfrage.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Button-specific form action</title>
</head>
<body>
<h1>Choose a form action</h1>
<form id="editor" action="#publish">
<button type="submit">Publish</button>
<button type="submit" formaction="#preview">Preview</button>
</form>
<p id="publish">Local publish destination.</p>
<p id="preview">Local preview destination.</p>
<script>
const form = document.getElementById('editor');
form.addEventListener('submit', event => {
event.preventDefault();
const button = event.submitter;
const action = button.hasAttribute('formaction') ? button.formAction : form.action;
console.log(`${button.textContent}: ${new URL(action).hash}`);
});
for (const button of form.querySelectorAll('button')) {
form.requestSubmit(button);
}
</script>
</body>
</html>Ergebnis
Publish: #publish Preview: #preview
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.