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 zur Manipulation der Optionen, des Layouts und der Darstellung von <input> Elementen.

Instanz-Eigenschaften

Erbt auch Eigenschaften von der übergeordneten Schnittstelle HTMLElement.

Einige Eigenschaften gelten nur für Eingabetypen, 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ünglich im HTML spezifizierten Standardwert darstellt, der dieses Objekt erstellt hat.
dirName: Ein String, der die Direktionalität des Elements darstellt.
incremental Nicht standardisiert: Ein Boolean, der den Modus des Auslösens des Suchereignisses darstellt; wenn true, wird es bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls, wenn Enter gedrückt wird.
labels Schreibgeschützt: Gibt eine Liste von <label>-Elementen zurück, die Bezeichnungen 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 bei der Formularübermittlung identifiziert.
popoverTargetAction: Ruft die Aktion ("hide", "show" oder "toggle") ab und setzt sie, die auf einem Popover-Element ausgeführt werden soll, das von einem <input> Element vom Typ type="button" gesteuert wird. Es spiegelt den Wert des popovertargetaction HTML-Attributs wider.
popoverTargetElement: Ruft das Popover-Element ab und setzt es, das über ein <input> Element vom Typ type="button" gesteuert werden soll. Das JavaScript-Äquivalent des popovertarget HTML-Attributs.
step: Ein String, der das step Attribut des Elements darstellt, das zusammen mit min und max verwendet wird, um die Inkremente zu begrenzen, bei denen ein numerischer oder Datums-/Zeitwert festgelegt werden kann. Es kann der String any oder eine positive Fließkommazahl sein. Wenn dies nicht auf any eingestellt ist, akzeptiert die Steuerung nur Werte, die Vielfache des Schrittwerts sind, größer als das Minimum.
type: Ein String, der das type Attribut des Elements darstellt und den Anzeigetyp der 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, interpretiert als Datum, oder null, wenn eine Umwandlung nicht möglich ist.
valueAsNumber: Eine Zahl, die den Wert des Elements darstellt, interpretiert als einer der folgenden Werte, in dieser 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 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 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 senden. Dies überschreibt das enctype Attribut des übergeordneten Formulars.
formMethod: Ein String, der das formmethod Attribut des Elements darstellt, das 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 wird, die nach der Übermittlung des Formulars empfangen wird. Dies überschreibt das target Attribut des übergeordneten Formulars.

Instanz-Eigenschaften, die auf jeden Eingabetyp zutreffen, der nicht versteckt ist

disabled: Ein Boolean, der das disabled Attribut des Elements darstellt und angibt, dass die Steuerung 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 ausfüllen muss, bevor das Formular übermittelt wird.
validationMessage Schreibgeschützt: Gibt eine lokalisierte Nachricht zurück, die die Validierungsbeschränkungen beschreibt, die die Steuerung nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn die Steuerung kein Kandidat für die Beschränkungsvalidierung ist (willValidate ist false), oder wenn sie ihre Beschränkungen erfüllt. Dieser Wert kann durch die Methode setCustomValidity() gesetzt 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 Beschränkungsvalidierung ist. Es ist false, wenn eine der Bedingungen es von der Beschränkungsvalidierung ausschließt, einschließlich: Ihr type ist einer von 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 Boolean, der den aktuellen Zustand des Elements darstellt.
defaultChecked: Ein Boolean, der den Standardzustand eines Optionsfelds oder Kontrollkästchens darstellt, wie er ursprünglich im HTML angegeben wurde, das dieses Objekt erstellt hat.
indeterminate: Ein Boolean, der angibt, ob das Kontrollkästchen oder das Optionsfeld in einem unbestimmten Zustand ist. Bei Kontrollkästchen hat dies zur Folge, dass das Erscheinungsbild des Kontrollkästchens in irgendeiner Weise verdunkelt/ausgegraut wird, um seinen Zustand als unbestimmt anzuzeigen (nicht geprüft, aber nicht ungeprüft). 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 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 und 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 Speicherort eines anzuzeigenden Bildes auf der grafischen Absenden-Schaltfläche angibt.
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 Kommata getrennte Liste von Dateitypen enthält, die ausgewählt werden können.
capture: Ein String, der das capture Attribut des Elements darstellt, das die Medienaufnahmeeingabemethode in Dateiupload-Steuerelementen angibt.
files: Eine FileList, die die zur Hochladung ausgewählten Dateien darstellt.
webkitdirectory: Ein Boolean, der das webkitdirectory Attribut darstellt. Wenn true, akzeptiert die Datei-/Verzeichnisauswahloberflä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 gelten, die Text oder Zahlen enthalten

autocomplete: Ein String, der das autocomplete Attribut des Elements darstellt, das angibt, ob der Wert der Steuerung automatisch vom Browser vervollständigt werden kann.
max: Ein String, der das max Attribut des Elements darstellt und den maximalen (numerischen oder datums-/zeitlichen) Wert für diesen Eintrag enthält, der nicht kleiner als sein minimaler (min Attribut) Wert sein darf.
maxLength: Eine Zahl, die das maxlength Attribut des Elements darstellt, das 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-/zeitlichen) Wert für diesen Eintrag enthält, der nicht größer als sein maximaler (max Attribut) Wert sein darf.
minLength: Eine Zahl, die das minlength Attribut des Elements darstellt, das 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 darauf enthält, was in die Steuerung 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 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 eine Schaltflächentyp ist.
selectionDirection: Ein String, der die Richtung darstellt, in der die Auswahl erfolgt ist. Mögliche Werte sind: forward (die Auswahl wurde in der Anfang-zu-Ende-Richtung der aktuellen Sprache 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 getroffen wurde, gibt dies den Offset des Zeichens zurück, das sich unmittelbar nach der aktuellen Textcursor-Position befindet.
selectionStart: Eine Zahl, die den Beginnindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position des Textcursors (der Einfügemarke) im <input> Element 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 von type ist text oder password, in diesem Fall ist es eine ganze Anzahl von Zeichen. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von der übergeordneten Schnittstelle HTMLElement.

checkValidity(): Gibt einen Boolean-Wert zurück, der false ist, wenn das Element ein Kandidat für die Beschränkungsvalidierung ist und nicht seine Beschränkungen 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 die Beschränkungsvalidierung ist oder seine Beschränkungen erfüllt.
reportValidity(): Führt die Methode checkValidity() aus, und wenn sie false zurückgibt (für eine ungültige Eingabe oder wenn kein Musterattribut vorhanden ist), meldet es dem Benutzer auf die gleiche Weise, als ob Sie ein Formular übermittelt hätten, dass die Eingabe ungültig ist.
select(): Wählt den gesamten Text im Eingabeelement aus und fokussiert es, sodass der Benutzer anschließend seinen gesamten Inhalt ersetzen kann.
setCustomValidity(): Legt eine benutzerdefinierte Validitätsnachricht für das Element fest. 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, 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 der übergeordneten Schnittstelle HTMLElement.

Hören Sie diese Ereignisse mithilfe von addEventListener() oder durch Zuordnen eines Ereignis-Listeners zur oneventname-Eigenschaft dieser Schnittstelle:

cancel event: Ausgelöst, wenn der Benutzer das Dateiauswahldialogfeld ü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 event: Ausgelöst, wenn ein Element seine Beschränkungen während der Beschränkungsvalidierung nicht erfüllt.
search event Nicht standardisiert: Ausgelöst, wenn eine Suche auf einem <input> vom Typ type="search" initiiert wird.
select event: Ausgelöst, wenn Text ausgewählt wurde.
selectionchange event: Wird ausgelöst, wenn die Textauswahl in einem <input> Element geändert wurde.

Spezifikationen

Specification
HTML # htmlinputelement

Browser-Kompatibilität

Siehe auch

HTML-Element, das diese Schnittstelle implementiert: <input>