HTMLInputElement

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.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Mehr erfahren
Vollständige Kompatibilität anzeigen

Die HTMLInputElement Schnittstelle bietet spezielle Eigenschaften und Methoden zur Manipulation der Optionen, des Layouts und der Darstellung von <input>-Elementen.

Instanz-Eigenschaften

Erbt auch Eigenschaften von ihrer übergeordneten Schnittstelle, HTMLElement.

Einige Eigenschaften gelten nur für Eingabeelementtypen, die die entsprechenden Attribute unterstützen.

align: Ein String, der die Ausrichtung des Elements darstellt. Verwenden Sie stattdessen CSS.
alpha: Ein Boolean, der das alpha-Attribut des Elements darstellt und anzeigt, ob die Alpha-Komponente der Farbe vom Endbenutzer manipuliert werden kann und nicht vollständig undurchsichtig sein muss.
colorSpace: Ein String, der das colorspace-Attribut des Elements darstellt und den Farbraum der serialisierten CSS-Farbe angibt (sRGB oder display-p3).
defaultValue: Ein String, der den Standardwert darstellt, wie er ursprünglich im HTML angegeben wurde, das dieses Objekt erstellt hat.
dirName: Ein String, der die Richtung des Elements darstellt.
incremental: Ein Boolean, der den Modus für das Auslösen des Suchevents darstellt. Wenn true, wird bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls beim Drücken von Enter.
labels Schreibgeschützt: Gibt eine Liste von <label>-Elementen zurück, die Etiketten für dieses Element sind.
list Schreibgeschützt: Gibt das Element zurück, auf das durch das list-Attribut verwiesen wird. Die Eigenschaft kann null sein, wenn kein HTML-Element im selben Baum gefunden wird.
multiple: Ein Boolean, der das multiple-Attribut des Elements darstellt und angibt, ob mehr als ein Wert möglich ist (z.B. mehrere Dateien).
name: Ein String, der das name-Attribut des Elements darstellt und einen Namen enthält, der das Element beim Absenden des Formulars identifiziert.
popoverTargetAction: Holt und setzt die auszuführende Aktion ("hide", "show" oder "toggle") für ein Popover-Element, das von einem <input>-Element vom Typ type="button" gesteuert wird. Es reflektiert den Wert des popovertargetaction-HTML-Attributs.
popoverTargetElement: Holt und setzt das Popover-Element, um es über ein <input>-Element vom Typ type="button" zu steuern. Das JavaScript-Äquivalent des popovertarget-HTML-Attributs.
step: Ein String, der das step-Attribut des Elements darstellt und mit min und max zusammenarbeitet, um die Schritte zu begrenzen, bei denen ein numerischer oder datumsbezogener Wert festgelegt werden kann. Es kann der String any oder eine positive Fließkommazahl sein. Wenn es nicht auf any gesetzt ist, akzeptiert das Steuerelement nur Werte bei Vielfachen des Schrittwerts, der größer als das Minimum ist.
type: Ein String, der das type-Attribut des Elements darstellt und den anzuzeigenden Steuerelementtyp angibt. Für mögliche Werte siehe die Dokumentation für das type-Attribut.
useMap: Ein String, der eine clientseitige Imagemap darstellt.
value: Ein String, der den aktuellen Wert des Steuerelements darstellt. Wenn der Benutzer einen Wert eingibt, der nicht dem erwarteten Wert entspricht, kann dies einen leeren String zurückgeben.
valueAsDate: Ein Date, der den Wert des Elements als Datum darstellt oder null, wenn die Umwandlung nicht möglich ist.
valueAsNumber: Eine Zahl, die den Wert des Elements darstellt, interpretiert als einen der folgenden Werte, in der Reihenfolge: ein Zeitwert, eine Zahl oder NaN, wenn die Umwandlung unmöglich ist.

Instanz-Eigenschaften in Bezug auf das übergeordnete Formular

form Schreibgeschützt: Gibt einen Verweis auf das übergeordnete <form>-Element zurück.
formAction: Ein String, der das formaction-Attribut des Elements darstellt und die URL eines Programms enthält, das die vom Element übermittelten Informationen verarbeitet. Dies überschreibt das action-Attribut des übergeordneten Formulars.
formEnctype: Ein String, der das formenctype-Attribut des Elements darstellt und den Inhaltstyp enthält, der verwendet wird, um das Formular an den Server zu übermitteln. Dies überschreibt das enctype-Attribut des übergeordneten Formulars.
formMethod: Ein String, der das formmethod-Attribut des Elements darstellt und die HTTP-Methode enthält, die der Browser verwendet, um das Formular zu übermitteln. Dies überschreibt das method-Attribut des übergeordneten Formulars.
formNoValidate: Ein Boolean, der das formnovalidate-Attribut des Elements darstellt und angibt, dass das Formular bei der Übermittlung nicht validiert werden soll. Dies überschreibt das novalidate-Attribut des übergeordneten Formulars.
formTarget: Ein String, der das formtarget-Attribut des Elements darstellt und einen Namen oder ein Schlüsselwort enthält, das angibt, wo die Antwort angezeigt werden soll, die nach dem Absenden des Formulars empfangen wird. Dies überschreibt das target-Attribut des übergeordneten Formulars.

Instanz-Eigenschaften, die für jeden nicht ausgeblendeten Eingabetyp gelten

disabled: Ein Boolean, der das disabled-Attribut des Elements darstellt und anzeigt, dass das Steuerelement nicht zur Interaktion verfügbar ist. Die Eingabewerte werden nicht mit dem Formular übermittelt. Siehe auch readonly.
required: Ein Boolean, der das required-Attribut des Elements darstellt und angibt, dass der Benutzer einen Wert eingeben muss, bevor das Formular abgeschickt wird.
validationMessage Schreibgeschützt: Gibt eine lokalisierte Nachricht zurück, die die Validierungseinschränkungen beschreibt, die das Steuerelement nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn das Steuerelement kein Kandidat für die Validierung von Einschränkungen ist (willValidate ist false) oder es seine Einschränkungen erfüllt. Dieser Wert kann durch die Methode setCustomValidity() festgelegt werden.
validity Schreibgeschützt: Gibt den aktuellen Validitätszustand des Elements zurück.
willValidate Schreibgeschützt: Gibt zurück, ob das Element ein Kandidat für die Validierung von Einschränkungen ist. Es ist false, wenn irgendwelche Bedingungen es von der Validierung von Einschränkungen ausschließen, einschließlich: sein type ist hidden, reset oder button, es hat einen <datalist>-Vorfahr oder seine disabled-Eigenschaft ist true.

Instanz-Eigenschaften, die nur für Elemente vom Typ Kontrollkästchen oder Radio gelten

checked: Ein Boolean, der den aktuellen Zustand des Elements darstellt.
defaultChecked: Ein Boolean, der den Standardzustand eines Radio-Buttons oder Kontrollkästchens darstellt, wie er ursprünglich im HTML angegeben wurde, das dieses Objekt erstellt hat.
indeterminate: Ein Boolean, der anzeigt, ob das Kontrollkästchen oder der Radio-Button sich in einem unbestimmten Zustand befindet. Bei Kontrollkästchen bewirkt dies, dass das Erscheinungsbild des Kontrollkästchens auf eine Art verschleiert/ausgegraut wird, die darauf hinweist, dass sein Zustand unbestimmt ist (nicht angekreuzt, aber auch nicht nicht-angehakt). Beeinflusst nicht den Wert des checked-Attributs und das Klicken auf das Kontrollkästchen setzt den Wert auf false.

Instanz-Eigenschaften, die nur für Elemente des Typs Bild gelten

alt: Ein String, der das alt-Attribut des Elements darstellt und Alternativtext zum Verwenden enthält.
height: Ein String, der das height-Attribut des Elements darstellt, welches die Höhe des für die Schaltfläche angezeigten Bildes definiert.
src: Ein String, der das src-Attribut des Elements darstellt, welches eine URI für den Speicherort eines Bildes angibt, das auf der grafischen Absende-Schaltfläche angezeigt werden soll.
width: Ein String, der das width-Attribut des Elements darstellt, welches die Breite des für die Schaltfläche angezeigten Bildes definiert.

Instanz-Eigenschaften, die nur für Elemente des Typs Datei gelten

accept: Ein String, der das accept-Attribut des Elements darstellt, welches eine durch Kommas getrennte Liste von Dateitypen enthält, die ausgewählt werden können.
capture: Ein String, der das capture-Attribut des Elements darstellt, welches die Medieneingabemethode in Dateiupload-Steuerelementen angibt.
files: Ein FileList, das die für den Upload ausgewählten Dateien darstellt.
webkitdirectory: Ein Boolean, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystem-Auswahloberfläche nur Verzeichnisse anstelle von Dateien.
webkitEntries Schreibgeschützt: Beschreibt die derzeit ausgewählten Dateien oder Verzeichnisse.

Instanz-Eigenschaften, die nur für sichtbare Elemente, die Text oder Zahlen enthalten, gelten

autocomplete: Ein String, der das autocomplete-Attribut des Elements darstellt und angibt, ob der Wert des Steuerelements vom Browser automatisch vervollständigt werden kann.
max: Ein String, der das max-Attribut des Elements darstellt, das den maximalen (numerischen oder datumsbezogenen) Wert für dieses Element enthält, der nicht kleiner als sein minimaler (min)-Attributswert sein darf.
maxLength: Eine Zahl, die das maxlength-Attribut des Elements darstellt und die maximale Anzahl von Zeichen (in Unicode-Codepoints) enthält, die der Wert haben kann.
min: Ein String, der das min-Attribut des Elements darstellt und den minimalen (numerischen oder datumsbezogenen) Wert für dieses Element enthält, der nicht größer als sein maximaler (max)-Attributswert sein darf.
minLength: Eine Zahl, die das minlength-Attribut des Elements darstellt und die minimale Anzahl von Zeichen (in Unicode-Codepoints) enthält, die der Wert haben kann.
pattern: Ein String, der das pattern-Attribut des Elements darstellt und ein reguläres Ausdruck enthält, gegen den der Wert des Steuerelements überprüft wird. Verwenden Sie das title-Attribut, um das Muster zu beschreiben, um dem Benutzer zu helfen. Dieses Attribut gilt nur, wenn der Wert des type-Attributs text, search, tel, url oder email ist.
placeholder: Ein String, der das placeholder-Attribut des Elements darstellt und einen Hinweis an den Benutzer enthält, was im Steuerelement eingegeben werden kann. Der Platzhaltertext darf keine Wagenrückläufe oder Zeilenumläufe enthalten. Dieses Attribut gilt nur, wenn der Wert des type-Attributs text, search, tel, url oder email ist.
readOnly: Ein Boolean, der das readonly-Attribut des Elements darstellt und angibt, dass der Benutzer den Wert des Steuerelements nicht ändern kann. Dies wird ignoriert, wenn der type hidden, range, color, checkbox, radio, file oder ein Button-Typ ist.
selectionDirection: Ein String, der die Richtung darstellt, in der die Auswahl erfolgte. Mögliche Werte sind: forward (die Auswahl wurde in der Start-zu-End-Richtung des aktuellen Gebietsschemas durchgeführt), backward (die entgegengesetzte Richtung) oder none (die Richtung ist unbekannt).
selectionEnd: Eine Zahl, die den Endindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies den Versatz des Zeichens unmittelbar hinter dem aktuellen Texteinfügezeiger zurück.
selectionStart: Eine Zahl, die den Beginnindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position des Texteinfügezeigers (Caret) innerhalb des <input>-Elements zurück.
size: Eine Zahl, die das size-Attribut des Elements darstellt und die visuelle Größe des Steuerelements enthält. Dieser Wert ist in Pixeln, es sei denn, der Wert von type ist text oder password, in welchem Fall es sich um eine ganze Anzahl von Zeichen handelt. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von ihrer übergeordneten Schnittstelle, HTMLElement.

checkValidity(): Gibt einen booleschen Wert zurück, der false ist, wenn das Element ein Kandidat für die Validierung von Einschränkungen ist und es nicht seine Einschränkungen erfüllt. In diesem Fall löst es auch ein invalid-Event am Element aus. Es gibt true zurück, wenn das Element kein Kandidat für die Validierung von Einschränkungen ist oder wenn es seine Einschränkungen erfüllt.
reportValidity(): Führt die checkValidity()-Methode aus und wenn sie false zurückgibt (für eine ungültige Eingabe oder kein Musterattribut vorhanden), dann wird dem Benutzer gemeldet, dass die Eingabe ungültig ist, auf dieselbe Weise wie beim Absenden eines Formulars.
select(): Wählt den gesamten Text im Eingabeelement aus und fokussiert es, sodass der Benutzer anschließend den gesamten Inhalt ersetzen kann.
setCustomValidity(): Legt eine benutzerdefinierte Fehlermeldung für das Element fest. Wenn diese Nachricht nicht der leere String ist, leidet das Element an einem benutzerdefinierten Gültigkeitsfehler und wird nicht validiert.
setRangeText(): Ersetzt einen Textbereich im Eingabeelement durch neuen Text.
setSelectionRange(): Wählt einen Textbereich im Eingabeelement aus (fokussiert es jedoch nicht).
showPicker(): Zeigt einen Browser-Auswahlbereich für Datum, Uhrzeit, Farbe und Dateien an.
stepDown(): Verringert den value um (step * n), wobei n standardmäßig 1 ist, wenn nicht angegeben.
stepUp(): Erhöht den value um (step * n), wobei n standardmäßig 1 ist, wenn nicht angegeben.

Ereignisse

Erbt auch Ereignisse von seiner übergeordneten Schnittstelle, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder durch Zuweisung eines Ereignislisteners zu der oneventname-Eigenschaft dieser Schnittstelle:

cancel Ereignis: Wird ausgelöst, wenn der Benutzer den Dateiauswahldialog über die Esc-Taste oder die Abbrechen-Schaltfläche abbricht und wenn der Benutzer dieselben Dateien erneut auswählt, die zuvor ausgewählt wurden.
invalid Ereignis: Wird ausgelöst, wenn ein Element seine Einschränkungen während der Einschränkungsvalidierung nicht erfüllt.
search Ereignis: Wird ausgelöst, wenn eine Suche auf einem <input> vom Typ type="search" gestartet wird.
select Ereignis: Wird ausgelöst, wenn Text ausgewählt wurde.
selectionchange Ereignis: Wird ausgelöst, wenn die Textauswahl in einem <input>-Element geändert wurde.

Spezifikationen

Spezifikation
HTML # htmlinputelement

Browser-Kompatibilität

Siehe auch

In diesem Interface implementiertes HTML-Element: <input>

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden