HTMLInputElement

Baseline Weitgehend verfgbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

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

EventTarget Node Element HTMLElement HTMLInputElement

Instanzeigenschaften

Erbt auch Eigenschaften von ihrer bergeordneten Schnittstelle, HTMLElement.

Einige Eigenschaften gelten nur fr Eingabeelementtypen, die die entsprechenden Attribute untersttzen.

align: Ein String, der die Ausrichtung des Elements darstellt. Verwenden Sie stattdessen CSS.
alpha: Ein Boolean, der das alpha-Attribut des Elements darstellt und angibt, ob der Alpha-Komponente der Farbe vom Benutzer manipuliert werden kann und nicht vollstndig undurchsichtig sein muss.
colorSpace: Ein String, der das colorspace-Attribut des Elements darstellt und den Farbraum der serialisierten CSS-Farbe (sRGB oder display-p3) angibt.
defaultValue: Ein String, der den Standardwert darstellt, wie er ursprnglich im HTML angegeben wurde, das dieses Objekt erstellt hat.
dirName: Ein String, der die Direktionalitt des Elements darstellt.
incremental: Ein Boolean, der den Auslsemodus des Suchevents darstellt. Wenn true, wird bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltflche ausgelst; andernfalls wird beim Drcken der Enter-Taste ausgelst.
labels Schreibgeschtzt: Gibt eine Liste von <label>-Elementen zurck, die Labels fr dieses Element sind.
list Schreibgeschtzt: Gibt das Element zurck, 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 mglich ist (z.B. mehrere Dateien).
name: Ein String, der das name-Attribut des Elements darstellt und einen Namen enthlt, der das Element beim Senden des Formulars identifiziert.
popoverTargetAction: Ruft die Aktion ab, die auf ein Popover-Element, das von einem <input>-Element vom Typ type="button" gesteuert wird, angewendet werden soll ("hide", "show" oder "toggle") und legt diese fest. Es spiegelt den Wert des popovertargetaction-HTML-Attributs wider.
popoverTargetElement: Ruft das zu steuernde Popover-Element ber ein <input>-Element vom Typ type="button" ab und legt es fest. 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 Schritte zu begrenzen, bei denen ein numerischer oder Datums-/Zeitwert festgelegt werden kann. Es kann der String any oder eine positive Gleitkommazahl sein. Wenn dies nicht auf any eingestellt ist, akzeptiert die Steuerung nur Werte in Vielfachen des Schrittwerts, die grer als das Minimum sind.
type: Ein String, der das type-Attribut des Elements darstellt und den anzuzeigenden Steuertyp angibt. Fr mgliche Werte siehe die Dokumentation des type-Attributs.
useMap: Ein String, der eine clientseitige Image-Map 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 zurckgeben.
valueAsDate: Ein Date, der den Wert des Elements darstellt, interpretiert als Datum, oder null, wenn die Umwandlung nicht mglich 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 unmglich ist.

Instanzeigenschaften in Bezug auf das bergeordnete Formular

form Schreibgeschtzt: Gibt eine Referenz auf das bergeordnete <form>-Element zurck.
formAction: Ein String, der das formaction-Attribut des Elements darstellt und die URL eines Programms enthlt, 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 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 und die HTTP-Methode enthlt, 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 Schlsselwort enthlt, 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 auf jeden sichtbaren Eingabetyp anwendbar sind, der nicht verborgen ist

disabled: Ein Boolean, der das disabled-Attribut des Elements darstellt und anzeigt, dass die Steuerung nicht zur Interaktion verfgbar ist. Die Eingabewerte werden nicht mit dem Formular gesendet. Siehe auch readonly.
required: Ein Boolean, der das required-Attribut des Elements darstellt und anzeigt, dass der Benutzer einen Wert eingeben muss, bevor ein Formular gesendet wird.
validationMessage Schreibgeschtzt: Gibt eine lokalisierte Nachricht zurck, die die Validierungsbeschrnkungen beschreibt, die die Steuerung nicht erfllt (falls vorhanden). Dies ist der leere String, wenn die Steuerung kein Kandidat fr die Validierung von Einschrnkungen ist (willValidate ist false), oder sie erfllt ihre Einschrnkungen. Dieser Wert kann mit der setCustomValidity()-Methode festgelegt werden.
validity Schreibgeschtzt: Gibt den aktuellen Gltigkeitsstatus des Elements zurck.
willValidate Schreibgeschtzt: Gibt zurck, ob das Element ein Kandidat fr die Validierung von Einschrnkungen ist. Es ist false, wenn irgendeine Bedingung es von der Validierung von Einschrnkungen ausschliet, einschlielich: Sein type ist einer von hidden, reset oder button, es hat einen <datalist>-Vorfahren oder seine disabled-Eigenschaft ist true.

Instanzeigenschaften, die nur bei Elementen vom Typ Checkbox oder Radio anwendbar sind

checked: Ein Boolean, der den aktuellen Zustand des Elements darstellt.
defaultChecked: Ein Boolean, der den Standardzustand einer Radiotaste oder eines Kontrollkstchens darstellt, wie er ursprnglich im HTML angegeben wurde, das dieses Objekt erstellt hat.
indeterminate: Ein Boolean, der darstellt, ob das Kontrollkstchen oder die Radiotaste in einem unbestimmten Zustand ist. Bei Kontrollkstchen hat dies die Wirkung, dass das Erscheinungsbild des Kontrollkstchens auf eine Weise verdeckt bzw. ausgegraut wird, die anzeigt, dass sein Zustand unbestimmt ist (nicht markiert, aber auch nicht nicht markiert). Dies beeinflusst nicht den Wert des checked-Attributs, und durch Klicken auf das Kontrollkstchen wird der Wert auf false gesetzt.

Instanzeigenschaften, die nur bei Elementen vom Typ Bild anwendbar sind

alt: Ein String, der das alt-Attribut des Elements darstellt und alternativen Text enthlt.
height: Ein String, der das height-Attribut des Elements darstellt, das die Hhe des angezeigten Bildes fr die Schaltflche definiert.
src: Ein String, der das src-Attribut des Elements darstellt, das eine URI fr den Speicherort eines Bildes angibt, das auf der grafischen Absenden-Schaltflche angezeigt werden soll.
width: Ein String, der das width-Attribut des Elements darstellt und die Breite des angezeigten Bildes fr die Schaltflche definiert.

Instanzeigenschaften, die nur auf Elemente vom Typ Datei anwendbar sind

accept: Ein String, der das accept-Attribut des Elements darstellt und eine durch Kommas getrennte Liste von Dateitypen enthlt, die ausgewhlt werden knnen.
capture: Ein String, der das capture-Attribut des Elements darstellt und den Medienaufnahme-Eingabemethode in Datei-Upload-Steuerelementen angibt.
files: Eine FileList, die die zur bertragung ausgewhlten Dateien darstellt.
webkitdirectory: Ein Boolean, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystemauswahloberflche nur Verzeichnisse anstelle von Dateien.
webkitEntries Schreibgeschtzt: Beschreibt die aktuell ausgewhlten Dateien oder Verzeichnisse.

Instanzeigenschaften, die nur auf sichtbare Elemente anwendbar sind, die Text oder Zahlen enthalten

autocomplete: Ein String, der das autocomplete-Attribut des Elements darstellt und angibt, ob der Wert der Steuerung automatisch vom Browser vervollstndigt werden kann.
max: Ein String, der das max-Attribut des Elements darstellt, das den maximalen (numerischen oder Datums-/Zeit-)Wert fr dieses Element enthlt, der nicht kleiner 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) enthlt, die der Wert haben kann.
min: Ein String, der das min-Attribut des Elements darstellt, das den minimalen (numerischen oder Datums-/Zeit-)Wert fr dieses Element enthlt, der nicht grer 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) enthlt, die der Wert haben kann.
pattern: Ein String, der das pattern-Attribut des Elements darstellt und ein regulrer Ausdruck enthlt, gegen den der Wert der Steuerung berprft wird. Verwenden Sie das title-Attribut, um das Muster zu beschreiben und 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 fr den Benutzer enthlt, was in die Steuerung eingegeben werden kann. Der Platzhaltertext darf keine Wagenrcklufe oder Zeilenumbrche 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 ein Schaltflchentyp ist.
selectionDirection: Ein String, der die Richtung darstellt, in der die Auswahl erfolgt ist. Mgliche Werte sind: forward (die Auswahl erfolgte in der Start-zu-Ende-Richtung der aktuellen Lokalisierung), backward (die entgegengesetzte Richtung) oder none (die Richtung ist unbekannt).
selectionEnd: Eine Zahl, die den Endindex des ausgewhlten Textes darstellt. Wenn keine Auswahl getroffen wurde, gibt dies den Offset des Zeichens unmittelbar nach der aktuellen Text-Cursor-Position zurck.
selectionStart: Eine Zahl, die den Anfangsindex des ausgewhlten Textes darstellt. Wenn nichts ausgewhlt ist, gibt dies die Position des Text-Cursors (Caret) innerhalb des <input>-Elements zurck.
size: Eine Zahl, die das size-Attribut des Elements darstellt und die visuelle Gre der Steuerung enthlt. Dieser Wert ist in Pixeln angegeben, es sei denn, der Wert von type ist text oder password, in diesem Fall ist es eine ganze Zahl der Zeichen. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanzmethoden

Erbt auch Methoden von ihrer bergeordneten Schnittstelle, HTMLElement.

checkValidity(): Gibt einen Boolean-Wert zurck, der false ist, wenn das Element ein Kandidat fr die Validierung von Einschrnkungen ist und seine Einschrnkungen nicht erfllt. In diesem Fall lst es auch ein invalid-Ereignis bei dem Element aus. Es gibt true zurck, wenn das Element kein Kandidat fr die Validierung von Einschrnkungen ist oder wenn es seine Einschrnkungen erfllt.
reportValidity(): Fhrt die checkValidity()-Methode aus und, wenn diese false (fr eine ungltige Eingabe oder kein bereitgestelltes Musterattribut) zurckgibt, meldet sie dem Benutzer auf die gleiche Weise wie beim Absenden eines Formulars, dass die Eingabe ungltig ist.
select(): Whlt den gesamten Text im Eingabeelement aus und fokussiert es, sodass der Benutzer anschlieend den gesamten Inhalt ersetzen kann.
setCustomValidity(): Setzt eine benutzerdefinierte Validierungsnachricht fr das Element. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Validittsfehler und validiert nicht.
setRangeText(): Ersetzt einen Textbereich im Eingabeelement durch neuen Text.
setSelectionRange(): Whlt einen Bereich von Text im Eingabeelement aus (fokussiert es aber nicht).
showPicker(): Zeigt einen Browser-Auswahldialog fr Datum, Zeit, Farbe und Dateien an.
stepDown(): Verringert den value um (step * n), wobei n standardmig 1 ist, wenn nicht angegeben.
stepUp(): Erhht den value um (step * n), wobei n standardmig 1 ist, wenn nicht angegeben.

Ereignisse

Erbt auch Ereignisse von ihrer bergeordneten Schnittstelle, HTMLElement.

Diese Ereignisse sollten durch die Verwendung von addEventListener() oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieser Schnittstelle angehrt werden:

cancel Ereignis: Wird ausgelst, wenn der Benutzer das Dateiauswahl-Dialogfeld ber die Esc-Taste oder die Abbrechen-Schaltflche abbricht und wenn der Benutzer dieselben Dateien erneut auswhlt, die zuvor ausgewhlt wurden.
invalid Ereignis: Wird ausgelst, wenn ein Element whrend der Validierung von Einschrnkungen seine Einschrnkungen nicht erfllt.
search Ereignis: Wird ausgelst, wenn eine Suche ber ein <input> vom Typ type="search" initiiert wird.
select Ereignis: Wird ausgelst, wenn ein Teil des Textes ausgewhlt wurde.
selectionchange Ereignis: Wird ausgelst, wenn die Textauswahl in einem <input>-Element gendert wurde.

Spezifikationen

Spezifikation
HTML # htmlinputelement

Browser-Kompatibilitt

Siehe auch

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

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden