HTMLInputElement

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

Instanzeigenschaften

Erbt auch Eigenschaften von seiner ü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 Standardwert darstellt, wie er ursprünglich im HTML spezifiziert wurde, das dieses Objekt erstellt hat.
dirName: Ein String, der die Richtung des Elements darstellt.
incremental Nicht standardisiert: Ein Boolean, der den Modus der Suchereignisauslösung darstellt. Wenn true, wird bei jedem Tastenanschlag oder beim Klicken auf die Abbrechen-Taste ausgelöst; andernfalls wird beim Drücken von Enter ausgelöst.
labels Nur lesbar: Gibt eine Liste von <label>-Elementen zurück, die Labels für dieses Element sind.
list Nur lesbar: 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 darstellt und einen Namen enthält, der das Element beim Senden des Formulars identifiziert.
popoverTargetAction: Ruft die auszuführende Aktion ab oder legt sie fest ("hide", "show" oder "toggle") für ein Popover-Element, das von einem <input>-Element vom Typ button gesteuert wird. Es spiegelt den Wert des popovertargetaction HTML-Attributes wider.
popoverTargetElement: Ruft das Popover-Element ab oder legt es fest, das über ein <input>-Element vom Typ button gesteuert wird. Das JavaScript-Äquivalent des popovertarget HTML-Attributes.
step: Ein String, der das step-Attribut des Elements darstellt, das mit min und max arbeitet, um die Inkremente zu begrenzen, bei denen ein numerischer oder datumszeitlicher 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 bei Vielfachen des Schrittswertes größer als das Minimum.
type: Ein String, der das type-Attribut des Elements darstellt und den anzuzeigenden Steuerungstyp 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 Wert eingibt als erwartet, kann dies einen leeren String zurückgeben.
valueAsDate: Ein Date, das den Wert des Elements als Datum darstellt, oder null, wenn eine Umwandlung nicht möglich ist.
valueAsNumber: Eine Zahl, die den Wert des Elements darstellt, der als einer der folgenden, in der Reihenfolge interpretiert wird: Ein Zeitwert, eine Zahl oder NaN, wenn eine Umwandlung unmöglich ist.

Instanzeigenschaften im Zusammenhang mit dem übergeordneten Formular

form Nur lesbar: 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 gesendeten Informationen verarbeitet. Dies überschreibt das action-Attribut des übergeordneten Formulars.
formEnctype: Ein String, der das formenctype-Attribut des Elements darstellt und die Art des Inhalts 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 und die HTTP-Methode enthält, die der Browser verwendet, um das Formular zu senden. Dies überschreibt das method-Attribut des übergeordneten Formulars.
formNoValidate: Ein Boolean, 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 Stichwort enthält, das angibt, wo die Antwort angezeigt werden soll, die nach dem Senden des Formulars empfangen wird. Dies überschreibt das target-Attribut des übergeordneten Formulars.

Instanzeigenschaften, die für jeden sichtbaren Eingabetyp gelten, der nicht ausgeblendet 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 gesendet. 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 senden kann.
validationMessage Nur lesbar: 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 das Steuerungselement kein Kandidat für die Validierung von Einschränkungen ist (willValidate ist false), oder es erfüllt seine Einschränkungen. Dieser Wert kann durch die Methode setCustomValidity() festgelegt werden.
validity Nur lesbar: Gibt den aktuellen Gültigkeitszustand des Elements zurück.
willValidate Nur lesbar: Gibt zurück, ob das Element ein Kandidat für die Validierung von Einschränkungen ist. Es ist false, wenn eine der Bedingungen es von der Validierung ausschließt, einschließlich: sein type ist eines der hidden, reset oder button, es hat einen <datalist>-Vorfahren oder sein disabled-Eigenschaft ist true.

Instanzeigenschaften, 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 Auswahl-Buttons oder einer Checkbox darstellt, wie ursprünglich im HTML spezifiziert, das dieses Objekt erstellt hat.
indeterminate: Ein Boolean, der angibt, ob die Checkbox oder der Radio-Button in einem unbestimmten Zustand ist. Bei Checkboxen bewirkt dies, dass das Erscheinungsbild der Checkbox auf irgendeine Weise verdeckt/ausgegraut wird, um anzuzeigen, dass ihr Zustand unbestimmt ist (nicht markiert, aber auch nicht unvermarkiert). Dies beeinflusst nicht den Wert des checked-Attributs, und das Klicken auf die Checkbox setzt den Wert auf false.

Instanzeigenschaften, die nur für Elemente vom Typ 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, welches die Höhe des für die Taste angezeigten Bildes definiert.
src: Ein String, der das src-Attribut des Elements darstellt, das eine URI für den Speicherort eines Bildes angibt, das auf der grafischen Senden-Taste angezeigt wird.
width: Ein String, der das width-Attribut des Elements darstellt, welches die Breite des für die Taste angezeigten Bildes definiert.

Instanzeigenschaften, die nur für Elemente vom Typ Datei 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 und die Eingabemethode zum Mediendatei-Capturing in Datei-Upload-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 Dateisystem-Auswahloberfläche nur Verzeichnisse anstelle von Dateien.
webkitEntries Nur lesbar: Beschreibt die aktuell ausgewählten Dateien oder Verzeichnisse.

Instanzeigenschaften, die nur für sichtbare Elemente gelten, die Text oder Zahlen enthalten

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 datumszeitlichen) Wert für diesen Eintrag enthält, der nicht kleiner als sein Minimum (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 datumszeitlichen) Wert für diesen Eintrag enthält, der nicht größer als sein Maximum (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 Attribut title, um das Muster zu beschreiben, um dem Benutzer zu helfen. Dieses Attribut gilt nur, wenn der Wert des Attributs type 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 in die Steuerung eingegeben werden kann. Der Platzhaltertext darf keine Wagenrückläufe oder Zeilenwechsel enthalten. Dieses Attribut gilt nur, wenn der Wert des Attributs type 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 ein Tasten-Typ ist.
selectionDirection: Ein String, der die Richtung angibt, in der die Auswahl erfolgte. Mögliche Werte sind: forward (die Auswahl wurde in der Start-zu-Ende-Richtung der aktuellen Sprache 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, wird der Offset des Zeichens unmittelbar nach der aktuellen Text-Eingabeposition zurückgegeben.
selectionStart: Eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position des Text-Eingabe-Cursors (Caret) innerhalb des <input>-Elements zurück.
size: Eine Zahl, die das size-Attribut des Elements darstellt, das 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 Zahl von Zeichen. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanzmethoden

Erbt auch Methoden von seiner übergeordneten Schnittstelle, HTMLElement.

checkValidity(): Gibt einen Boolean-Wert zurück, der false ist, wenn das Element ein Kandidat für die Validierung von Einschränkungen ist und es 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 die Validierung von Einschränkungen ist oder wenn es seine Einschränkungen erfüllt.
reportValidity(): Führt die Methode checkValidity() aus und wenn es false zurückgibt (für eine ungültige Eingabe oder wenn kein Pattern-Attribut bereitgestellt wurde), dann wird dem Benutzer gemeldet, dass die Eingabe ungültig ist, in derselben Weise, als ob Sie ein Formular einreichen würden.
select(): Wählt den gesamten Text im Eingabefeld aus und fokussiert ihn, sodass der Benutzer anschließend alle Inhalte 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 eine Textrange im Eingabefeld durch neuen Text.
setSelectionRange(): Wählt eine Textrange im Eingabefeld aus (fokussiert es jedoch nicht).
showPicker(): Zeigt einen Browser-Picker für Datum, Zeit, Farbe und Dateien an.
stepDown(): Verringert den value um (step * n), wobei n standardmäßig auf 1 gesetzt ist, wenn nichts angegeben ist.
stepUp(): Erhöht den value um (step * n), wobei n standardmäßig auf 1 gesetzt ist, wenn nichts angegeben ist.

Ereignisse

Erbt auch Ereignisse von seiner übergeordneten Schnittstelle, 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 das Dateiauswahl-Dialogfeld über die Esc-Taste oder die Abbrechen-Taste 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 Nicht standardisiert: Wird ausgelöst, wenn eine Suche bei einem <input> vom Typ search initiiert wird.
select Ereignis: Wird ausgelöst, wenn Text ausgewählt wurde.
selectionchange Ereignis Experimentell: Wird ausgelöst, wenn die Textauswahl in einem <input>-Element geändert wurde.

Spezifikationen

Specification
HTML Standard # htmlinputelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

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