WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen