<form>: Das Formularelement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Das <form>
HTML Element repräsentiert einen Dokumentenabschnitt, der interaktive Steuerelemente zum Übermitteln von Informationen enthält.
Probieren Sie es aus
Es ist möglich, die :valid
und :invalid
CSS-Pseudoklassen zu verwenden, um ein <form>
-Element zu gestalten, basierend darauf, ob die elements
innerhalb des Formulars gültig sind.
Attribute
Dieses Element enthält die globalen Attribute.
accept
Veraltet-
Durch Kommas getrennte Inhaltstypen, die der Server akzeptiert.
Note: Dieses Attribut ist veraltet und sollte nicht verwendet werden. Stattdessen sollte das
accept
Attribut auf<input type=file>
Elementen verwendet werden. accept-charset
-
Die vom Server akzeptierte Zeichenkodierung. Die Spezifikation erlaubt einen einzelnen wertunabhängigen Wert von
"UTF-8"
, was die Allgegenwärtigkeit dieser Kodierung widerspiegelt (historisch konnten mehrere Zeichenkodierungen als durch Kommas oder Leerzeichen getrennte Liste angegeben werden). autocapitalize
-
Steuert, ob eingegebener Text automatisch großgeschrieben wird und, falls ja, in welcher Weise. Weitere Informationen finden Sie auf der Seite des globalen Attributs
autocapitalize
. autocomplete
-
Gibt an, ob Eingabeelemente standardmäßig automatisch vom Browser ausgefüllt werden können.
autocomplete
Attribute auf Formularelementen überschreiben es auf<form>
. Mögliche Werte:off
: Der Browser darf Einträge nicht automatisch ausfüllen. (Browser neigen dazu, dies bei verdächtigen Anmeldeformularen zu ignorieren; siehe Verwaltung von Autofill für Anmeldefelder.)on
: Der Browser darf Einträge automatisch ausfüllen.
name
-
Der Name des Formulars. Der Wert darf nicht die leere Zeichenfolge sein und muss innerhalb der Formularelemente, in denen es sich befindet, eindeutig sein, falls vorhanden.
rel
-
Steuert die Annotationen und welche Arten von Links das Formular erstellt. Zu den Annotationen gehören
external
,nofollow
,opener
,noopener
undnoreferrer
. Linktypen beinhaltenhelp
,prev
,next
,search
undlicense
. Derrel
Wert ist eine durch Leerzeichen getrennte Liste dieser enumerierten Werte.
Attribute zur Formularübermittlung
Die folgenden Attribute steuern das Verhalten während der Formularübermittlung.
action
-
Die URL, die die Formularübermittlung verarbeitet. Dieser Wert kann von einem
formaction
Attribut auf einem<button>
,<input type="submit">
oder<input type="image">
Element überschrieben werden. Dieses Attribut wird ignoriert, wennmethod="dialog"
gesetzt ist. enctype
-
Wenn der Wert des
method
-Attributspost
ist, istenctype
der MIME-Typ der Formularübermittlung. Mögliche Werte:application/x-www-form-urlencoded
: Der Standardwert.multipart/form-data
: Verwenden Sie dies, wenn das Formular<input>
Elemente mittype=file
enthält.text/plain
: Nützlich zu Debugging-Zwecken.
Dieser Wert kann durch
formenctype
Attribute auf<button>
,<input type="submit">
oder<input type="image">
Elementen überschrieben werden. method
-
Die HTTP Methode zur Übermittlung des Formulars. Die einzigen erlaubten Methoden/Werte sind (unabhängig von Groß-/Kleinschreibung):
post
: DiePOST
Methode; Formulardaten werden als Request-Body gesendet.get
(Standard): DieGET
; Formulardaten werden mit einem?
-Separator an dieaction
-URL angehängt. Verwenden Sie diese Methode, wenn das Formular keine Nebeneffekte hat.dialog
: Wenn das Formular in einem<dialog>
enthalten ist, schließt es den Dialog und verursacht einsubmit
Event bei der Übermittlung, ohne Daten zu übermitteln oder das Formular zu leeren.
Dieser Wert wird durch
formmethod
Attribute auf<button>
,<input type="submit">
oder<input type="image">
Elementen überschrieben. novalidate
-
Dieses boolesche Attribut gibt an, dass das Formular bei der Übermittlung nicht validiert werden soll. Wenn dieses Attribut nicht gesetzt ist (und das Formular daher wird validiert), kann es durch ein
formnovalidate
Attribut auf einem<button>
,<input type="submit">
oder<input type="image">
Element, das zum Formular gehört, überschrieben werden. target
-
Gibt an, wo die Antwort nach Übermittlung des Formulars angezeigt werden soll. Es ist ein Name/Schlüsselwort für einen Browsing-Kontext (zum Beispiel Tab, Fenster oder iframe). Die folgenden Schlüsselwörter haben besondere Bedeutungen:
_self
(Standard): In den gleichen Browsing-Kontext wie den aktuellen laden._blank
: In einen neuen, unbenannten Browsing-Kontext laden. Dies bietet dasselbe Verhalten wie das Setzen vonrel="noopener"
, das nichtwindow.opener
setzt._parent
: In den übergeordneten Browsing-Kontext des aktuellen laden. Wenn kein übergeordneter vorhanden ist, verhält sich wie_self
._top
: In den obersten Browsing-Kontext laden (d. h. den Browsing-Kontext, der ein Vorfahre des aktuellen ist und keinen übergeordneten hat). Wenn kein übergeordneter vorhanden ist, verhält sich wie_self
._unfencedTop
: Läd die Antwort eines Formulars innerhalb eines eingebetteten fenced frame in das oberste Frame (d. h. über das Root des fenced frame hinausgehend, im Gegensatz zu anderen reservierten Zielen). Nur innerhalb von fenced frames verfügbar.
Dieser Wert kann durch ein
formtarget
Attribut auf einem<button>
,<input type="submit">
oder<input type="image">
Element überschrieben werden.
Beispiele
<!-- Form which will send a GET request to the current URL -->
<form method="get">
<label>
Name:
<input name="submitted-name" autocomplete="name" />
</label>
<button>Save</button>
</form>
<!-- Form which will send a POST request to the current URL -->
<form method="post">
<label>
Name:
<input name="submitted-name" autocomplete="name" />
</label>
<button>Save</button>
</form>
<!-- Form with fieldset, legend, and label -->
<form method="post">
<fieldset>
<legend>Do you agree to the terms?</legend>
<label><input type="radio" name="radio" value="yes" /> Yes</label>
<label><input type="radio" name="radio" value="no" /> No</label>
</fieldset>
</form>
Ergebnis
Technische Zusammenfassung
Inhaltskategorien | Flussinhalt, greifbarer Inhalt |
---|---|
Erlaubter Inhalt | Flussinhalt, darf jedoch keine <form> Elemente enthalten |
Tag-Auslassung | Keine, sowohl das startende als auch das endende Tag sind obligatorisch. |
Erlaubte Eltern | Jedes Element, das Flussinhalt akzeptiert |
Implizite ARIA Rolle | form |
Erlaubte ARIA Rollen |
search ,
none
oder presentation
|
DOM-Schnittstelle | [`HTMLFormElement`](/de/docs/Web/API/HTMLFormElement) |
Spezifikationen
Specification |
---|
HTML Standard # the-form-element |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- HTML Formulare Leitfaden
- Andere Elemente, die zur Erstellung von Formularen verwendet werden:
<button>
,<datalist>
,<fieldset>
,<input>
,<label>
,<legend>
,<meter>
,<optgroup>
,<option>
,<output>
,<progress>
,<select>
,<textarea>
. - Eine Liste der Elemente im Formular erhalten:
HTMLFormElement.elements
- ARIA: Formrolle
- ARIA: Suchrolle