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 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 kannnull
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 Typbutton
kontrolliert wird. Es reflektiert den Wert despopovertargetaction
-HTML-Attributs. popoverTargetElement
-
Ruft das Popover-Element ab und setzt es, um über ein
<input>
-Element vom Typbutton
zu kontrollieren. Das JavaScript-Äquivalent despopovertarget
-HTML-Attributs. step
-
Ein String, der das
step
-Attribut des Elements darstellt, was in Verbindung mitmin
undmax
verwendet wird, um die Schritte zu begrenzen, mit denen ein numerischer oder datum-/uhrzeitbezogener Wert festgelegt werden kann. Es kann der Stringany
oder eine positive Gleitkommazahl sein. Wenn dies nicht aufany
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 dastype
-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, odernull
, 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 dasaction
-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 dasenctype
-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 dasmethod
-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 dasnovalidate
-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 dastarget
-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 auchreadonly
. 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
istfalse
) oder wenn sie ihre Einschränkungen erfüllt. Dieser Wert kann durch die MethodesetCustomValidity()
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: seintype
ist eines derhidden
,reset
oderbutton
, es hat einen<datalist>
-Vorfahren oder seinedisabled
-Eigenschaft isttrue
.
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. Wenntrue
, 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 dastitle
-Attribut, um das Muster zu beschreiben, um dem Benutzer zu helfen. Dieses Attribut gilt nur, wenn der Wert destype
-Attributstext
,search
,tel
,url
oderemail
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 destype
-Attributstext
,search
,tel
,url
oderemail
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 dertype
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) odernone
(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 destype
isttext
oderpassword
, in diesem Fall ist es eine ganzzahlige Anzahl von Zeichen. Gilt nur, wenntype
auftext
,search
,tel
,url
,email
oderpassword
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 eininvalid
-Ereignis am Element ausgelöst. Es gibttrue
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 siefalse
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.
search
Ereignis Nicht standardisiert-
Wird ausgelöst, wenn eine Suche über ein
<input>
vontype="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>