HTMLInputElement

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Eltern-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.

alpha Experimentell

Ein Boolean, der das alpha-Attribut des Elements darstellt und anzeigt, ob der Benutzer den Alpha-Wert der Farbe manipulieren kann und dieser nicht vollständig deckend sein muss.

colorSpace Experimentell

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 Leserichtung des Elements darstellt.

incremental Nicht standardisiert

Ein Boolean, der den Suchereignismodus darstellt. Wenn true, wird bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls wird beim Drücken von 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 vom list-Attribut verwiesen wird. Die Eigenschaft kann null sein, wenn kein HTML-Element im gleichen 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 und setzt sie, die an einem Popover-Element, das von einem <input>-Element des Typs type="button" gesteuert wird, ausgeführt werden soll ("hide", "show" oder "toggle"). Es spiegelt den Wert des popovertargetaction-HTML-Attributs wider.

popoverTargetElement

Ruft das Popover-Element ab und setzt es, das über ein <input>-Element des Typs type="button" gesteuert werden soll. Das JavaScript-Äquivalent zum popovertarget-HTML-Attribut.

step

Ein String, der das step-Attribut des Elements darstellt, welches mit min und max zusammenarbeitet, um die Schritte zu begrenzen, in denen ein Zahlen- oder Datumswert festgelegt werden kann. Es kann der String any oder eine positive Gleitkommazahl sein. Wenn dies nicht auf any gesetzt ist, akzeptiert die Steuerung nur Werte in Vielfachen des Schrittwertes, die größer als das Minimum sind.

type

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

useMap Veraltet

Ein String, der eine client-seitige Bildkarte darstellt.

value

Ein String, der den aktuellen Wert der Steuerung darstellt. Wenn der Benutzer einen von dem erwarteten Wert abweichenden Wert eingibt, kann dies einen leeren String zurückgeben.

valueAsDate

Ein Date, der den Wert des Elements als Datum interpretiert darstellt oder null, wenn die Umwandlung nicht möglich ist.

valueAsNumber

Eine Zahl, die den Wert des Elements darstellt, interpretiert als einer der folgenden (in der Reihenfolge): Ein Zeitwert, eine Zahl oder NaN, wenn die Umwandlung unmöglich ist.

Instanz-Eigenschaften im Zusammenhang mit dem übergeordneten Formular

form Schreibgeschützt

Gibt eine Referenz zum übergeordneten <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 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 senden. Dies überschreibt das method-Attribut des übergeordneten Formulars.

formNoValidate

Ein Boolean, der das formnovalidate-Attribut des Elements darstellt und angibt, dass das Formular beim Absenden nicht validiert werden soll. Dies überschreibt das novalidate-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 werden soll, die nach dem Senden des Formulars empfangen wird. Dies überschreibt das target-Attribut des übergeordneten Formulars.

Instanz-Eigenschaften, die für jeden Typ von Eingabeelement gelten, das nicht versteckt ist

disabled

Ein Boolean, der das disabled-Attribut des Elements darstellt und angibt, dass die Steuerung nicht für Interaktionen 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 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 ist false), oder ihre Einschränkungen erfüllt. Dieser Wert kann mit der setCustomValidity()-Methode 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 irgendeine Bedingung es von der Einschränkungsvalidierung ausschließt, einschließlich: Sein type ist einer von hidden, reset oder button, es hat einen <datalist>-Vorfahren oder seine disabled-Eigenschaft ist true.

Instanz-Eigenschaften, die nur für Elemente vom Typ Kontrollkästchen oder Radio gelten

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 den Effekt, dass das Erscheinungsbild des Kontrollkästchens in irgendeiner Weise verdeckt/ausgegraut wird, um anzuzeigen, dass sein Zustand unbestimmt ist (nicht markiert, aber auch nicht nicht markiert). Beeinflusst nicht den Wert des checked-Attributes, und das Klicken 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, das alternativen Text enthält, der verwendet werden soll.

height

Ein String, der das height-Attribut des Elements darstellt, das die Höhe des für die Schaltfläche angezeigten Bildes definiert.

src

Ein String, der das src-Attribut des Elements darstellt, welches 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, das die Breite des für die Schaltfläche angezeigten Bildes definiert.

Instanz-Eigenschaften, die nur für Elemente vom Typ Datei gelten

accept

Ein String, der das accept-Attribut des Elements darstellt, das 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 Methode der Media-Erfassung in Datei-Upload-Steuerungen angibt.

files

Eine FileList, die die für den Upload ausgewählten Dateien darstellt.

webkitdirectory

Ein Boolean, der das webkitdirectory-Attribut darstellt. Wenn true, akzeptiert die Dateisystem-Auswahloberfläche 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 automatisch vom Browser vervollständigt werden kann.

max

Ein String, der das max-Attribut des Elements darstellt und den maximalen (numerischen oder datumsbezogenen) Wert für dieses Element 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 datumsbezogenen) Wert für dieses Element 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, das ein reguläres Ausdrucksmuster enthält, gegen das der Wert der Steuerung geprü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-Attributes text, search, tel, url oder email 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 Zeilenumbrüche enthalten. Dieses Attribut gilt nur, wenn der Wert des type-Attributes 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 Button-Typ ist.

selectionDirection

Ein String, der die Richtung darstellt, in der die Auswahl erfolgt ist. Mögliche Werte sind: forward (die Auswahl wurde in der Start-zu-Ende-Richtung der aktuellen Lokalität 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 besteht, gibt dies den Offset des Zeichens unmittelbar nach der aktuellen Text-Eingabemarke zurück.

selectionStart

Eine Zahl, die den Startindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt dies die Position der Text-Eingabemarke (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 von type ist text oder password, in welchem Fall es sich um eine ganze Zahl von Zeichen handelt. Gilt nur, wenn type auf text, search, tel, url, email oder password gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von seinem Eltern-Interface, HTMLElement.

checkValidity()

Gibt einen Boolean-Wert zurück, der false ist, wenn das Element ein Kandidat für die Einschränkungsvalidierung ist und es seine Einschränkungen nicht 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 Einschränkungsvalidierung ist oder es seine Einschränkungen erfüllt.

reportValidity()

Führt die Methode checkValidity() aus, und wenn sie false zurückgibt (für eine ungültige Eingabe oder kein bereitgestelltes Pattern-Attribut), dann meldet sie dem Benutzer in derselben Weise, dass die Eingabe ungültig ist, als ob Sie ein Formular gesendet hätten.

select()

Wählt den gesamten Text im Eingabeelement aus und fokussiert ihn, 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, dann hat das Element einen benutzerdefinierten Gültigkeitsfehler und validiert nicht.

setRangeText()

Ersetzt einen Textbereich im Eingabeelement durch neuen Text.

setSelectionRange()

Wählt einen Bereich von Text im Eingabeelement aus (fokussiert es jedoch nicht).

showPicker()

Zeigt ein Browser-Auswahlwerkzeug 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.

Ereignisse

Erbt auch Ereignisse von seinem Eltern-Interface, HTMLElement.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener auf die oneventname-Eigenschaft dieses Interfaces zuweisen:

cancel Ereignis

Wird ausgelöst, wenn der Benutzer den Datei-Auswahldialog ü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 seine Einschränkungen während der Einschränkungsvalidierung nicht erfüllt.

search Ereignis Nicht standardisiert

Wird ausgelöst, wenn eine Suche in einem <input> vom type="search" initiiert 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

Browser-Kompatibilität

Siehe auch

• HTML-Element, das dieses Interface implementiert: <input>