CKTIS / HTML
formenctype — Datenformat für eine bestimmte Submit-Schaltfläche
Mit dem Attribut formenctype kann eine Submit-Schaltfläche das enctype des Formulars überschreiben. Es legt das Datenformat der POST-Anfrage nur fest, wenn das Formular mit dieser Schaltfläche abgesendet wird.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype legt das Datenformat fest, das eine bestimmte Submit-Schaltfläche eines Formulars verwendet. Es gilt für ein button, das als Submit-Schaltfläche dient, sowie für input mit type="submit" oder type="image". Bei button ist es sinnvoll, type="submit" ausdrücklich anzugeben. Die Überschreibung wirkt sich nur auf das Absenden mit dieser Schaltfläche aus; das enctype-Attribut des Formulars wird dadurch nicht geändert.
Zulässige Werte sind application/x-www-form-urlencoded (prozentkodierte Name-Wert-Paare), multipart/form-data (separate Teile, die Dateiinhalt übertragen können) und text/plain (ein lesbares, aber mehrdeutiges Format, das sich nicht für zuverlässiges Parsen eignet).
Fehlt formenctype, wird das enctype des zugehörigen Formulars verwendet. Ein leerer oder ungültiger Wert wählt dagegen application/x-www-form-urlencoded und fällt nicht auf die Einstellung des Formulars zurück. Fehlt auch dem Formular enctype, ist sein Standardformat application/x-www-form-urlencoded.
Beim Senden über HTTP bestimmt dieses Format den Inhalt der POST-Anfrage; es ändert die Methode nicht in POST. Bei GET werden die Daten unabhängig von formenctype mit application/x-www-form-urlencoded in die URL aufgenommen. In JavaScript heißt die reflektierende Eigenschaft formEnctype. Das Beispiel bricht das Absenden ab und zeigt das ausgewählte Format an, ohne eine Anfrage zu senden.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>formenctype demo</title>
<form id="demo" method="post" enctype="application/x-www-form-urlencoded">
<input name="message" value="hello world" aria-label="Message">
<button type="submit">Default</button>
<button type="submit" formenctype="multipart/form-data">Multipart</button>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const button = event.submitter;
result.textContent = button && button.hasAttribute('formenctype')
? button.formEnctype
: form.enctype;
});
</script>
</html>Ergebnis
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
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.