WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

form — HTML-Formular

Das form-Element ordnet Steuerelemente einem Formular zu und legt fest, wie ihre Daten übermittelt werden. Es unterstützt die native Übermittlung und Validierung; JavaScript kann die Übermittlung abfangen.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<form action="/search" method="get">…</form>

form stellt ein Formular dar, dessen Steuerelemente Daten zur Verarbeitung bereitstellen können. Öffnendes und schließendes Tag sind erforderlich; Formulare dürfen nicht ineinander verschachtelt werden. Unterstützte Steuerelemente außerhalb des Formulars lassen sich über ein form-Attribut zuordnen, das auf dessen id verweist.

action gibt das Ziel an. method="get" (der Standardwert) fügt die Daten der URL-Abfrage hinzu, während method="post" sie in den Anfrageinhalt aufnimmt. Für Datei-Uploads mit POST verwenden Sie enctype="multipart/form-data". POST allein bietet keine Verschlüsselung.

Datenschlüssel stammen aus name, nicht aus id. Deaktivierte Steuerelemente und nicht angekreuzte Kontrollkästchen werden ausgelassen. Steuerelemente ohne Namen werden normalerweise ausgelassen. Wird das Formular jedoch über eine grafische Schaltfläche (<input type="image">) ohne Namen abgeschickt, fügt diese den Formulardaten Koordinateneinträge mit den Namen x und y hinzu. Ordnen Sie Beschriftungen den Feldern zu. Die Browser-Validierung unterstützt Nutzende, ersetzt aber keine serverseitige Validierung.

Bei einer normalen Übermittlung findet die interaktive Validierung vor dem Ereignis submit statt, sofern sie nicht übersprungen wird. Schlägt die Validierung fehl, wird die Übermittlung abgebrochen und das Ereignis submit nicht ausgelöst. Das Attribut novalidate überspringt die interaktive Validierung. Bevorzugen Sie in Skripten requestSubmit(): Anders als submit() erhält es die Validierung und das Ereignis submit.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML form example</title>
</head>
<body>
  <form id="search" method="get">
    <label for="query">Query</label>
    <input id="query" name="q" value="html" required>
    <button id="submit-query" type="submit">Submit query</button>
  </form>
  <output id="result" for="query" aria-live="polite"></output>
  <script>
    const form = document.getElementById('search');
    const submitButton = document.getElementById('submit-query');
    const result = document.getElementById('result');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      const data = new FormData(form);
      result.value = 'q=' + data.get('q');
      console.log(result.value);
    });

    form.requestSubmit(submitButton);
  </script>
</body>
</html>

Ergebnis

q=html

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