HTMLInputElement

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.

* Some parts of this feature may have varying levels of support.

Das HTMLInputElement-Interface bietet spezielle Eigenschaften und Methoden zum Manipulieren der Optionen, des Layouts und der Darstellung von <input>-Elementen.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seiner Eltern-Interface, HTMLElement.

Einige Eigenschaften gelten nur für input-Elementtypen, die die entsprechenden Attribute unterstützen.

align Veraltet: Ein String, der die Ausrichtung des Elements darstellt. Verwenden Sie stattdessen CSS.
defaultValue: Ein String, der den ursprünglichen Standardwert darstellt, wie er im HTML angegeben wurde, das dieses Objekt erstellt hat.
dirName: Ein String, der die Direktionalität des Elements darstellt.
incremental Nicht standardisiert: Ein boolescher Wert, der den Modus des search-Ereignisfeuers darstellt. Wenn true, wird bei jedem Tastendruck oder Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls, beim Drücken der Enter-Taste.
labels Schreibgeschützt: Gibt eine Liste von <label>-Elementen zurück, die Beschriftungen für dieses Element sind.
list Schreibgeschützt: Gibt das durch das list-Attribut angegebene Element zurück. Die Eigenschaft kann null sein, wenn kein HTML-Element im gleichen Baum gefunden wurde.
multiple: Ein boolescher Wert, 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: Ruft die Aktion ab und setzt sie, die auf ein von einem <input>-Element des Typs button gesteuertes Popover-Element ausgeführt werden soll ("hide", "show", oder "toggle"). Es spiegelt den Wert des popovertargetaction-HTML-Attributs wider.
popoverTargetElement: Ruft das durch ein <input>-Element des Typs button zu steuernde Popover-Element ab und setzt es. Das JavaScript-Äquivalent des popovertarget-HTML-Attributs.
step: Ein String, der das step-Attribut des Elements darstellt, das zusammen mit min und max die Inkremente beschränkt, bei denen ein numerischer oder datums-/uhrzeitbezogener Wert gesetzt werden kann. Dies kann der String any oder eine positive Gleitkommazahl sein. Wenn dies nicht auf any gesetzt ist, akzeptiert die Steuerung nur Werte als Vielfache des Schrittwertes, die größer als das Minimum sind.
type: Ein String, der das type-Attribut des Elements darstellt und den Typ der anzuzeigenden Steuerung angibt. Für mögliche Werte siehe die Dokumentation zum type-Attribut.
useMap Veraltet: Ein String, der eine clientseitige Bildkarte darstellt.
value: Ein String, der den aktuellen Wert der Steuerung darstellt. Wenn der Benutzer einen anderen als den erwarteten Wert eingibt, kann dies einen leeren String zurückgeben.
valueAsDate: Ein Date, der den Wert des Elements darstellt, als Datum interpretiert, oder null, wenn die Umwandlung nicht möglich ist.
valueAsNumber: Eine Zahl, die den Wert des Elements darstellt, interpretiert als eines der folgenden, in der Reihenfolge: Ein Zeitwert, eine Zahl oder NaN, wenn die Umwandlung unmöglich ist.

Instanz-Eigenschaften im Zusammenhang mit dem übergeordneten Formular

form Schreibgeschützt: Gibt eine Referenz 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 Informationen verarbeitet, die durch das Element übermittelt werden. Dies überschreibt das action-Attribut des übergeordneten Formulars.
formEnctype: Ein String, der das formenctype-Attribut des Elements darstellt, das den Typ des Inhalts angibt, der verwendet wird, um das Formular an den Server zu senden. Dies überschreibt das enctype-Attribut des übergeordneten Formulars.
formMethod: Ein String, der das formmethod-Attribut des Elements darstellt, welches die HTTP-Methode enthält, die der Browser verwendet, um das Formular zu senden. Dies überschreibt das method-Attribut des übergeordneten Formulars.
formNoValidate: Ein boolescher Wert, der das formnovalidate-Attribut des Elements darstellt und angibt, dass das Formular nicht validiert werden soll, wenn es gesendet wird. 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 der Übermittlung des Formulars empfangen wurde. Dies überschreibt das target-Attribut des übergeordneten Formulars.

Instanz-Eigenschaften, die für jeden Typ von `input`-Element gelten, der nicht verborgen ist

disabled: Ein boolescher Wert, der das disabled-Attribut des Elements darstellt, das angibt, dass die Steuerung nicht für Interaktionen verfügbar ist. Die Eingabewerte werden nicht mit dem Formular gesendet. Siehe auch readonly.
required: Ein boolescher Wert, der das required-Attribut des Elements darstellt, das angibt, dass der Benutzer einen Wert eingeben muss, bevor er ein Formular absendet.
validationMessage Schreibgeschützt: Gibt eine lokalisierte Nachricht zurück, die die Validierungseinschränkungen beschreibt, die die Steuerung nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn die Steuerung kein Kandidat für die Einschränkungsvalidierung ist (willValidate ist false) oder sie ihre Einschränkungen erfüllt. Dieser Wert kann durch die setCustomValidity()-Methode gesetzt werden.
validity Schreibgeschützt: Gibt den aktuellen Gültigkeitsstatus des Elements zurück.
willValidate Schreibgeschützt: Gibt zurück, ob das Element ein Kandidat für Einschränkungsvalidierung ist. Es ist false, wenn irgendwelche Bedingungen es von Einschränkungsvalidierung ausschließen, einschließlich: sein type ist hidden, reset oder button, es hat einen <datalist>-Vorfahren oder seine disabled-Eigenschaft ist true.

Instanz-Eigenschaften, die nur für Elemente des Typs `checkbox` oder `radio` gelten

checked: Ein boolescher Wert, der den aktuellen Zustand des Elements darstellt.
defaultChecked: Ein boolescher Wert, der den Standardzustand einer Radio-Schaltfläche oder eines Kontrollkästchens darstellt, wie ursprünglich im HTML angegeben, das dieses Objekt erstellt hat.
indeterminate: Ein boolescher Wert, der angibt, ob das Kontrollkästchen oder die Radio-Schaltfläche in einem unbestimmten Zustand ist. Für Kontrollkästchen bedeutet dies, dass das Erscheinungsbild des Kontrollkästchens irgendwie verdeckt/ausgegraut ist, um anzuzeigen, dass sein Zustand unbestimmt ist (nicht aktiviert, aber auch nicht deaktiviert). 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 `image` gelten

alt: Ein String, der das alt-Attribut des Elements darstellt und alternativen Text enthält, der verwendet werden soll.
height: Ein String, der das height-Attribut des Elements darstellt, das die Höhe des für die Schaltfläche angezeigten Bildes definiert.
src: Ein String, der das src-Attribut des Elements darstellt, das eine URI für den Standort eines Bildes angibt, das auf der grafischen Senden-Schaltfläche angezeigt werden soll.
width: Ein String, der das width-Attribut des Elements darstellt, das die Breite des für die Schaltfläche angezeigten Bildes definiert.

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

accept: Ein String, der das accept-Attribut des Elements darstellt und 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, das die Mediendateneingabemethode in Datei-Upload-Steuerelementen angibt.
files: Ein FileList, das die für den Upload ausgewählten Dateien darstellt.
webkitdirectory: Ein boolescher Wert, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystemauswahloberfläche nur Verzeichnisse statt Dateien.
webkitEntries Schreibgeschützt: Beschreibt die aktuell ausgewählten Dateien oder Verzeichnisse.

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

autocomplete: Ein String, der das autocomplete-Attribut des Elements darstellt und angibt, ob der Wert der Steuerung vom Browser automatisch vervollständigt werden kann.
max: Ein String, der das max-Attribut des Elements darstellt und den maximalen (numerischen oder datums-/uhrzeitbezogenen) Wert für dieses Element enthält, der nicht geringer als sein Mindestwert (min-Attribut) sein darf.
maxLength: Eine Zahl, die das maxlength-Attribut des Elements darstellt und die maximale Anzahl von Zeichen (in Unicode-Codepunkten) enthält, die der Wert haben kann.
min: Ein String, der das min-Attribut des Elements darstellt und den minimalen (numerischen oder datums-/uhrzeitbezogenen) Wert für dieses Element enthält, der nicht größer als sein Maximalwert (max-Attribut) sein darf.
minLength: Eine Zahl, die das minlength-Attribut des Elements darstellt und die minimale Anzahl von Zeichen (in Unicode-Codepunkten) enthält, die der Wert haben kann.
pattern: Ein String, der das pattern-Attribut des Elements darstellt und einen regulären Ausdruck enthält, gegen den der Wert der Steuerung ü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 für den Benutzer enthält, was in die Steuerung eingegeben werden kann. Der Platzhaltertext darf keine Wagenrückläufe oder Zeilenumbrüche enthalten. Dieses Attribut gilt nur, wenn der Wert des type-Attributs text, search, tel, url oder email ist.
readOnly: Ein boolescher Wert, der das readonly-Attribut des Elements darstellt und angibt, dass der Benutzer den Wert der Steuerung nicht ändern kann. Dies wird ignoriert, wenn der type hidden, range, color, checkbox, radio, file oder ein Schaltflächentyp ist.
selectionDirection: Ein String, der die Richtung angibt, in die die Auswahl erfolgt ist. Mögliche Werte sind: forward (die Auswahl wurde in der von Anfang zu Ende gerichteten Richtung des aktuellen Gebietsschemas vorgenommen), backward (die entgegengesetzte Richtung) oder none (die Richtung ist unbekannt).
selectionEnd: Eine Zahl, die den Endindex des ausgewählten Textes darstellt. Wenn keine Auswahl besteht, gibt dies den Offset des Zeichens unmittelbar nach der aktuellen Textcursor-Position zurück.
selectionStart: Eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, wird damit die Position des Texteingabe-Cursors (Caret) innerhalb des <input>-Elements zurückgegeben.
size: Eine Zahl, die das size-Attribut des Elements darstellt und die visuelle Größe der Steuerung enthält. Dieser Wert ist in Pixel, es sei denn, der Wert von type ist text oder password, in welchem Fall er eine ganze Anzahl von Zeichen ist. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von seiner Eltern-Interface, HTMLElement.

checkValidity(): Gibt einen booleschen Wert zurück, der false ist, wenn das Element ein Kandidat für Einschränkungsvalidierung ist und seine Einschränkungen nicht erfüllt. In diesem Fall löst es auch ein invalid-Ereignis am Element aus. Es gibt true zurück, wenn das Element kein Kandidat für Einschränkungsvalidierung ist oder seine Einschränkungen erfüllt.
reportValidity(): Führt die checkValidity()-Methode aus und meldet dem Benutzer, dass die Eingabe ungültig ist, falls sie false zurückgibt (für eine ungültige Eingabe oder kein bereitgestelltes Muster-Attribut), auf die gleiche Weise, als ob Sie ein Formular gesendet hätten.
select(): Wählt den gesamten Text im input-Element aus und fokussiert es, sodass der Benutzer anschließend den gesamten Inhalt ersetzen kann.
setCustomValidity(): Setzt eine benutzerdefinierte Fehlermeldung für das Element. 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 input-Element durch neuen Text.
setSelectionRange(): Wählt einen Bereich von Text im input-Element aus (aber fokussiert ihn nicht).
showPicker(): Zeigt eine Browser-Auswahl für Datum, Zeit, 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 Eltern-Interface, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener auf die oneventname-Eigenschaft dieser Schnittstelle zuweisen:

cancel Ereignis: Wird ausgelöst, wenn der Benutzer den Dateiauswahl-Dialog über die Esc-Taste oder die Abbrechen-Schaltfläche schließt und wenn der Benutzer dieselben Dateien erneut auswählt, die zuvor ausgewählt wurden.
invalid Ereignis: Wird ausgelöst, wenn ein Element während der Einschränkungsvalidierung seine Einschränkungen nicht erfüllt.
search Ereignis Nicht standardisiert: Wird ausgelöst, wenn eine Suche auf einem <input> mit type="search" initiiert wird.
select Ereignis: Wird ausgelöst, wenn Text ausgewählt wurde.
selectionchange Ereignis Experimentell: Wird ausgelöst, wenn sich die Textauswahl in einem <input>-Element geändert hat.

Spezifikationen

Specification
HTML Standard # htmlinputelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

HTML-Element, das dieses Interface implementiert: <input>