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.

EventTarget Node Element HTMLElement HTMLInputElement

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Interface, HTMLElement.

Einige Eigenschaften gelten nur für Eingabeelementtypen, 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 Standardwert darstellt, wie er ursprünglich im HTML angegeben wurde, das dieses Objekt erstellt hat.

dirName

Ein String, der die Direktionalität des Elements darstellt.

incremental Nicht standardisiert

Ein Boolean, der den Suchereignis-Abfeuermodus darstellt, falls true, wird bei jedem Tastenanschlag oder beim Klicken auf die Abbrechentaste ein Ereignis ausgelöst; ansonsten wird beim Drücken der Taste Enter ausgelöst.

labels Schreibgeschützt

Gibt eine Liste von <label>-Elementen zurück, die Labels 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, das angibt, ob mehr als ein Wert möglich ist (z.B. mehrere Dateien).

name

Ein String, der das name-Attribut des Elements repräsentiert und einen Namen enthält, der das Element beim Absenden des Formulars identifiziert.

popoverTargetAction

Ruft die Aktion ab und setzt sie, die auf einem Steuer-popover-Element auszuführen ist ("hide", "show" oder "toggle"), das durch ein <input>-Element vom Typ button kontrolliert wird. Es reflektiert den Wert des popovertargetaction-HTML-Attributs.

popoverTargetElement

Ruft das Popover-Element ab und setzt es, um über ein <input>-Element vom Typ button zu kontrollieren. Das JavaScript-Äquivalent des popovertarget-HTML-Attributs.

step

Ein String, der das step-Attribut des Elements darstellt, was in Verbindung mit min und max verwendet wird, um die Schritte zu begrenzen, mit denen ein numerischer oder datum-/uhrzeitbezogener Wert festgelegt werden kann. Es kann der String any oder eine positive Gleitkommazahl sein. Wenn dies nicht auf any gesetzt ist, akzeptiert die Steuerung nur Werte in Vielfachen des Schrittwerts, die größer als das Minimum sind.

type

Ein String, der das type-Attribut des Elements darstellt, was den Anzeigetyp der Steuerung angibt. Für mögliche Werte siehe die Dokumentation für das 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, das den Wert des Elements darstellt, interpretiert als Datum, oder null, wenn die Umwandlung nicht möglich ist.

valueAsNumber

Eine Zahl, die den Wert des Elements repräsentiert, interpretiert als einer der folgenden, in Reihenfolge: Ein Zeitwert, eine Nummer oder NaN, wenn die Umwandlung unmöglich ist.

Instanz-Eigenschaften in Bezug zum ü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, das 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, das 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, was angibt, dass das Formular nicht validiert wird, wenn es übermittelt wird. Dies überschreibt das novalidate-Attribut des übergeordneten Formulars.

formTarget

Ein String, der das formtarget-Attribut des Elements darstellt, das einen Namen oder ein Schlüsselwort enthält, das angibt, wo die Antwort angezeigt wird, die nach der Übermittlung des Formulars empfangen wird. Dies überschreibt das target-Attribut des übergeordneten Formulars.

Instanz-Eigenschaften, die für jeden sichtbaren Eingabetyp gelten, der nicht verborgen ist

disabled

Ein Boolean, 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 übermittelt. Siehe auch readonly.

required

Ein Boolean, der das required-Attribut des Elements darstellt und angibt, dass der Benutzer einen Wert eingeben muss, bevor er ein Formular absenden kann.

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 wenn sie ihre Einschränkungen erfüllt. Dieser Wert kann durch die Methode setCustomValidity() festgelegt werden.

validity Schreibgeschützt

Gibt den aktuellen Gültigkeitszustand des Elements zurück.

willValidate Schreibgeschützt

Gibt zurück, ob das Element ein Kandidat für die Einschränkungsvalidierung ist. Es ist false, wenn eine der Bedingungen es von der Einschränkungsvalidierung ausschließt, einschließlich: sein type ist eines der hidden, reset oder button, es hat einen <datalist>-Vorfahren oder seine disabled-Eigenschaft ist true.

Instanz-Eigenschaften, die nur für Elemente vom Typ Checkbox oder Radio gelten

checked

Ein Boolean, der den aktuellen Zustand des Elements darstellt.

defaultChecked

Ein Boolean, der den Standardzustand eines Optionsfelds oder einer Kontrollkästchen wie ursprünglich im HTML angegeben darstellt, das dieses Objekt erstellt hat.

indeterminate

Ein Boolean, der darstellt, ob das Kontrollkästchen oder das Optionsfeld im unbestimmten Zustand ist. Für Kontrollkästchen hat dies zur Folge, dass das Erscheinungsbild des Kontrollkästchens auf irgendeine Weise verdeckt/grau angezeigt wird, um anzuzeigen, dass sein Zustand unbestimmt ist (nicht angekreuzt, aber auch nicht nicht angekreuzt). Beeinflusst nicht den Wert des checked-Attributs, und ein Klick auf das Kontrollkästchen setzt den Wert auf false.

Instanz-Eigenschaften, die nur für Elemente vom Typ Bild gelten

alt

Ein String, der das alt-Attribut des Elements darstellt und einen Alternativtext enthält, der verwendet werden soll.

height

Ein String, der das height-Attribut des Elements darstellt, welches die Höhe des für den Button angezeigten Bildes definiert.

src

Ein String, der das src-Attribut des Elements darstellt und einen URI für den Speicherort eines Bildes enthält, das auf der grafischen Senden-Schaltfläche angezeigt werden soll.

width

Ein String, der das width-Attribut des Elements darstellt, welches die Breite des für den Button angezeigten Bildes definiert.

Instanz-Eigenschaften, die nur für Elemente vom Typ Datei gelten

accept

Ein String, der das accept-Attribut des Elements darstellt und eine kommagetrennte Liste von Dateitypen enthält, die ausgewählt werden können.

capture

Ein String, der das capture-Attribut des Elements darstellt und die Medienaufnahme-Eingabemethode in Datei-Upload-Steuerelementen angibt.

files

Eine FileList, die die für den Upload ausgewählten Dateien darstellt.

webkitdirectory

Ein Boolean, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystemauswahl-Schnittstelle nur Verzeichnisse anstelle von Dateien.

webkitEntries Schreibgeschützt

Beschreibt die derzeit 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 ausgefüllt werden kann.

max

Ein String, der das max-Attribut des Elements darstellt und den maximalen (numerischen oder datum-/uhrzeitbezogenen) Wert für dieses Element enthält, der nicht kleiner sein darf als sein Mindestwert (min-Attribut).

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 datum-/uhrzeitbezogenen) Wert für dieses Element enthält, der nicht größer sein darf als sein Maximalwert (max-Attribut).

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 das Steuerelement eingegeben werden kann. Der Platzhaltertext darf keine Wagenrückläufe oder Zeilenwechsel 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, was 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 Button-Typ ist.

selectionDirection

Ein String, der die Richtung angibt, in der die Auswahl erfolgt ist. Mögliche Werte sind: forward (die Auswahl wurde in der Start-zum-Ende-Richtung der aktuellen Lokalisierung durchgeführt), backward (die entgegengesetzte Richtung) oder none (die Richtung ist unbekannt).

selectionEnd

Eine Zahl, die den Endindex des ausgewählten Textes darstellt. Wenn keine Auswahl vorhanden ist, gibt dies den Versatz des Zeichens direkt hinter der aktuellen Textcursorposition zurück.

selectionStart

Eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position des Texteingabecursors (Caret) innerhalb des <input>-Elements zurück.

size

Eine Zahl, die das size-Attribut des Elements darstellt und die visuelle Größe der Steuerung enthält. Dieser Wert ist in Pixeln, es sei denn, der Wert des type ist text oder password, in diesem Fall ist es eine ganzzahlige Anzahl von Zeichen. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von seinem übergeordneten Interface, HTMLElement.

checkValidity()

Gibt einen Boolean-Wert zurück, der false ist, wenn das Element ein Kandidat für die Einschränkungsvalidierung ist und seine Einschränkungen nicht erfüllt. In diesem Fall wird auch ein invalid-Ereignis am Element ausgelöst. Es gibt true zurück, wenn das Element kein Kandidat für die Einschränkungsvalidierung ist oder wenn es seine Einschränkungen erfüllt.

reportValidity()

Führt die Methode checkValidity() aus und meldet dem Benutzer, dass die Eingabe ungültig ist, auf die gleiche Weise, als ob man ein Formular übermittelt hätte, wenn sie false zurückgibt (für eine ungültige Eingabe oder kein übergebenes Pattern-Attribut).

select()

Wählt den gesamten Text im Eingabeelement aus und fokussiert es, damit 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 Validitätsfehler 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-Auswahldialog für Datum, Zeit, Farbe und Dateien an.

stepDown()

Verringert den value um (step * n), wobei n standardmäßig 1 ist, falls nicht angegeben.

stepUp()

Erhöht den value um (step * n), wobei n standardmäßig 1 ist, falls nicht angegeben.

Ereignisse

Erbt auch Ereignisse von seinem übergeordneten Interface, HTMLElement.

Diese Ereignisse können mit addEventListener() oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces gehört werden:

cancel Ereignis

Wird ausgelöst, wenn der Benutzer den Datei-Auswahldialog über die Taste Esc 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.

Wird ausgelöst, wenn eine Suche über ein <input> von type="search" gestartet wird.

select Ereignis

Wird ausgelöst, wenn ein Text ausgewählt wurde.

selectionchange Ereignis

Wird ausgelöst, wenn sich die Textauswahl in einem <input>-Element geändert hat.

Spezifikationen

Specification
HTML
# htmlinputelement

Browser-Kompatibilität

Siehe auch

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