HTMLFormElement

Baseline

Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Das HTMLFormElement Interface repräsentiert ein <form> Element im DOM. Es ermöglicht den Zugriff auf – und in einigen Fällen die Modifikation von – Aspekten des Formulars sowie den Zugang zu seinen Komponentenelementen.

Instanz-Eigenschaften

Dieses Interface erbt auch Eigenschaften von seinem übergeordneten Element, HTMLElement.

HTMLFormElement.acceptCharset: Ein String, der den Wert des HTML-Attributs accept-charset des Formulars widerspiegelt.
HTMLFormElement.action: Ein String, der den Wert des HTML-Attributs action des Formulars widerspiegelt und die URI eines Programms enthält, das die vom Formular übermittelten Informationen verarbeitet.
HTMLFormElement.autocomplete: Ein String, der den Wert des HTML-Attributs autocomplete des Formulars widerspiegelt, welches angibt, ob die Steuerungen in diesem Formular automatisch vom Browser ausgefüllt werden können.
HTMLFormElement.encoding oder HTMLFormElement.enctype: Ein String, der den Wert des HTML-Attributs enctype des Formulars widerspiegelt, der den Typ des Inhalts angibt, der verwendet wird, um das Formular zum Server zu übertragen. Nur angegebene Werte können gesetzt werden. Die beiden Eigenschaften sind synonym.
HTMLFormElement.elements Schreibgeschützt: Eine HTMLFormControlsCollection, die alle Formularsteuerungen enthält, die zu diesem Formularelement gehören.
HTMLFormElement.length Schreibgeschützt: Ein long, der die Anzahl der Steuerungen im Formular widerspiegelt.
HTMLFormElement.name: Ein String, der den Wert des HTML-Attributs name des Formulars widerspiegelt und den Namen des Formulars enthält.
HTMLFormElement.noValidate: Ein boolescher Wert, der den Wert des HTML-Attributs novalidate des Formulars widerspiegelt und angibt, ob das Formular nicht validiert werden soll.
HTMLFormElement.method: Ein String, der den Wert des HTML-Attributs method des Formulars widerspiegelt, der die HTTP-Methode angibt, die für das Einreichen des Formulars verwendet wird. Nur angegebene Werte können gesetzt werden.
HTMLFormElement.rel: Ein String, der den Wert des HTML-Attributs rel des Formulars widerspiegelt, welcher die Art der vom Formular erstellten Links als durch Leerzeichen getrennte Liste von aufgezählten Werten darstellt.
HTMLFormElement.relList Schreibgeschützt: Eine DOMTokenList, die das HTML-Attribut rel als Liste von Tokens widerspiegelt.
HTMLFormElement.target: Ein String, der den Wert des HTML-Attributs target des Formulars widerspiegelt und angibt, wo die Ergebnisse der Formularübermittlung angezeigt werden sollen.

Benannte Eingaben werden ihrer Besitzerform als Eigenschaften hinzugefügt und können native Eigenschaften überschreiben, wenn sie denselben Namen teilen (z.B. ein Formular mit einer Eingabe namens action wird seine action Eigenschaft anstelle des HTML-Attributs action des Formulars zurückgeben).

Instanz-Methoden

Dieses Interface erbt auch Methoden von seinem übergeordneten Element, HTMLElement.

checkValidity(): Gibt true zurück, wenn die untergeordneten Steuerungen des Elements der Constraint-Validierung unterliegen und diese Einschränkungen erfüllen; gibt false zurück, wenn einige Steuerungen ihre Einschränkungen nicht erfüllen. Löst ein Ereignis namens invalid bei jeder Steuerung aus, die ihre Einschränkungen nicht erfüllt; solche Steuerungen gelten als ungültig, wenn das Ereignis nicht abgebrochen wird. Es liegt am Programmierer, zu entscheiden, wie auf false reagiert wird.
reportValidity(): Gibt true zurück, wenn die untergeordneten Steuerungen des Elements ihre Validierungseinschränkungen erfüllen. Wenn false zurückgegeben wird, werden stornierbare invalid Ereignisse für jedes ungültige Kind ausgelöst und Validierungsprobleme dem Benutzer gemeldet.
requestSubmit(): Fordert an, dass das Formular unter Verwendung des angegebenen Absende-Buttons und seiner entsprechenden Konfiguration gesendet wird.
reset(): Setzt das Formular in seinen Anfangszustand zurück.
submit(): Sendet das Formular zum Server.

Ereignisse

Sie können diese Ereignisse mit addEventListener() überwachen oder einen Ereignis-Listener der Eigenschaft oneventname dieses Interfaces zuweisen.

formdata: Das formdata Ereignis wird ausgelöst, nachdem die Eintragsliste, die die Formulardaten darstellt, erstellt wurde.
reset: Das reset Ereignis wird ausgelöst, wenn ein Formular zurückgesetzt wird.
submit: Das submit Ereignis wird ausgelöst, wenn ein Formular gesendet wird.

Anwendungshinweise

Abrufen eines Formularelement-Objekts

Um ein HTMLFormElement Objekt zu erhalten, können Sie einen CSS-Selektor mit querySelector() verwenden, oder Sie können eine Liste aller Formulare im Dokument mit seiner forms Eigenschaft abrufen.

Document.forms gibt ein Array von HTMLFormElement Objekten zurück, das jedes Formular auf der Seite auflistet. Sie können dann eine der folgenden Syntaxen verwenden, um ein einzelnes Formular zu erhalten:

document.forms[index]: Gibt das Formular am angegebenen index im Array der Formulare zurück.
document.forms[id]: Gibt das Formular zurück, dessen ID das id ist.
document.forms[name]: Gibt das Formular zurück, dessen name Attributswert