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.
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 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 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 Typbutton
gesteuert wird. Es spiegelt den Wert despopovertargetaction
HTML-Attributes wider. popoverTargetElement
-
Ruft das Popover-Element ab oder legt es fest, das über ein
<input>
-Element vom Typbutton
gesteuert wird. Das JavaScript-Äquivalent despopovertarget
HTML-Attributes. step
-
Ein String, der das
step
-Attribut des Elements darstellt, das mitmin
undmax
arbeitet, um die Inkremente zu begrenzen, bei denen ein numerischer oder datumszeitlicher Wert festgelegt werden kann. Es kann der Stringany
oder eine positive Gleitkommazahl sein. Wenn dies nicht aufany
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 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 Wert eingibt als erwartet, kann dies einen leeren String zurückgeben.
valueAsDate
-
Ein
Date
, das den Wert des Elements als Datum darstellt, odernull
, 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 dasaction
-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 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 senden. Dies überschreibt dasmethod
-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 dasnovalidate
-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 dastarget
-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 auchreadonly
. 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
istfalse
), oder es erfüllt seine Einschränkungen. Dieser Wert kann durch die MethodesetCustomValidity()
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: seintype
ist eines derhidden
,reset
oderbutton
, es hat einen<datalist>
-Vorfahren oder seindisabled
-Eigenschaft isttrue
.
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. Wenntrue
, 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 Attributtitle
, um das Muster zu beschreiben, um dem Benutzer zu helfen. Dieses Attribut gilt nur, wenn der Wert des Attributstype
text
,search
,tel
,url
oderemail
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 Attributstype
text
,search
,tel
,url
oderemail
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 dertype
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) odernone
(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 vontype
isttext
oderpassword
, in diesem Fall ist es eine ganze Zahl von Zeichen. Gilt nur, wenntype
auftext
,search
,tel
,url
,email
oderpassword
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 eininvalid
-Ereignis am Element aus. Es gibttrue
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 Typsearch
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>