Baseline Widely available *
Das HTMLInputElement
Interface bietet spezielle Eigenschaften und Methoden zur Manipulation der Optionen, des Layouts und der Darstellung von <input>
Elementen.
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.
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.
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
.
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.
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.
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.
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.
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.
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.
<input>
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4