HTMLInputElement

Instanzeigenschaften

Erbt auch Eigenschaften von ihrer übergeordneten Schnittstelle, 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.

alpha Experimentell

Ein Boolean, der das alpha-Attribut des Elements darstellt und angibt, ob der Alpha-Komponente der Farbe vom Benutzer manipuliert werden kann und nicht vollständig 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 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 Auslösemodus des Suchevents darstellt. Wenn true, wird bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls wird beim Drücken der Enter-Taste 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 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 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 größer als das Minimum sind.

type

Ein String, der das type-Attribut des Elements darstellt und den anzuzeigenden Steuertyp angibt. Für mögliche Werte siehe die Dokumentation des type-Attributs.

useMap Veraltet

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 zurückgeben.

valueAsDate

Ein Date, der den Wert des Elements darstellt, interpretiert als Datum, oder null, wenn die 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.

Instanzeigenschaften in Bezug auf das übergeordnete Formular

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 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 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 Schlüsselwort 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 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 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 anzeigt, dass der Benutzer einen Wert eingeben muss, bevor ein Formular gesendet 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 Validierung von Einschränkungen ist (willValidate ist false), oder sie erfüllt ihre Einschränkungen. Dieser Wert kann mit der setCustomValidity()-Methode festgelegt werden.

validity Schreibgeschützt

Gibt den aktuellen Gültigkeitsstatus des Elements zurück.

willValidate Schreibgeschützt

Gibt zurück, ob das Element ein Kandidat für die Validierung von Einschränkungen ist. Es ist false, wenn irgendeine Bedingung es von der Validierung von Einschränkungen ausschließt, einschließlich: 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 Kontrollkästchens darstellt, wie er ursprünglich im HTML angegeben wurde, das dieses Objekt erstellt hat.

indeterminate

Ein Boolean, der darstellt, ob das Kontrollkästchen oder die Radiotaste in einem unbestimmten Zustand ist. Bei Kontrollkästchen hat dies die Wirkung, dass das Erscheinungsbild des Kontrollkästchens 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 Kontrollkästchen 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 enthält.

height

Ein String, der das height-Attribut des Elements darstellt, das die Höhe des angezeigten Bildes für die Schaltfläche 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 Absenden-Schaltfläche angezeigt werden soll.

width

Ein String, der das width-Attribut des Elements darstellt und die Breite des angezeigten Bildes für die Schaltfläche 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 enthält, die ausgewählt werden können.

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 ausgewählten Dateien darstellt.

webkitdirectory

Ein Boolean, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystemauswahloberfläche nur Verzeichnisse anstelle von Dateien.

webkitEntries Schreibgeschützt

Beschreibt die aktuell ausgewählten 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 vervollständigt werden kann.

max

Ein String, der das max-Attribut des Elements darstellt, das den maximalen (numerischen oder Datums-/Zeit-)Wert für dieses Element enthält, 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) enthält, die der Wert haben kann.

min

Ein String, der das min-Attribut des Elements darstellt, das den minimalen (numerischen oder Datums-/Zeit-)Wert für dieses Element enthält, der nicht größer 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) enthält, die der Wert haben kann.

pattern

Ein String, der das pattern-Attribut des Elements darstellt und ein regulärer Ausdruck enthält, gegen den der Wert der Steuerung überprüft 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 für den Benutzer enthält, was in die Steuerung eingegeben werden kann. Der Platzhaltertext darf keine Wagenrückläufe oder Zeilenumbrüche 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 Schaltflächentyp ist.

selectionDirection

Ein String, der die Richtung darstellt, in der die Auswahl erfolgt ist. Mögliche 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 ausgewählten Textes darstellt. Wenn keine Auswahl getroffen wurde, gibt dies den Offset des Zeichens unmittelbar nach der aktuellen Text-Cursor-Position zurück.

selectionStart

Eine Zahl, die den Anfangsindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position des Text-Cursors (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 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 zurück, der false ist, wenn das Element ein Kandidat für die Validierung von Einschränkungen ist und seine Einschränkungen nicht erfüllt. In diesem Fall löst es auch ein invalid-Ereignis bei dem 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 checkValidity()-Methode aus und, wenn diese false (für eine ungültige Eingabe oder kein bereitgestelltes Musterattribut) zurückgibt, meldet sie dem Benutzer auf die gleiche Weise wie beim Absenden eines Formulars, dass die Eingabe ungültig ist.

select()

Wählt den gesamten Text im Eingabeelement aus und fokussiert es, sodass der Benutzer anschließend den gesamten Inhalt ersetzen kann.

setCustomValidity()

Setzt eine benutzerdefinierte Validierungsnachricht für das Element. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Validitätsfehler und validiert nicht.

setRangeText()

Ersetzt einen Textbereich im Eingabeelement durch neuen Text.

setSelectionRange()

Wählt einen Bereich von Text im Eingabeelement aus (fokussiert es aber 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, wenn nicht angegeben.

stepUp()

Erhöht den value um (step * n), wobei n standardmäßig 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 angehört werden:

cancel Ereignis

Wird ausgelöst, wenn der Benutzer das Dateiauswahl-Dialogfeld ü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 Ereignis

Wird ausgelöst, wenn ein Element während der Validierung von Einschränkungen seine Einschränkungen nicht erfüllt.

search Ereignis Nicht standardisiert

Wird ausgelöst, wenn eine Suche über ein <input> vom Typ type="search" initiiert wird.

select Ereignis

Wird ausgelöst, wenn ein Teil des Textes ausgewählt wurde.

selectionchange Ereignis

Wird ausgelöst, wenn die Textauswahl in einem <input>-Element geändert wurde.

Spezifikationen

Browser-Kompatibilität

Siehe auch

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