DasHTMLInputElement-Interface bietet spezielle Eigenschaften und Methoden zur Manipulation der Optionen, des Layouts und der Darstellung von<input>-Elementen.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Eltern-Interface,HTMLElement.

Einige Eigenschaften gelten nur für Eingabeelementtypen, die die entsprechenden Attribute unterstützen.

alignVeraltet

Ein String, der die Ausrichtung des Elements darstellt.Verwenden Sie stattdessen CSS.

alphaExperimentell

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

colorSpaceExperimentell

Ein String, der dascolorspace-Attribut des Elements darstellt und denFarbraum 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.

incrementalNicht standardisiert

Ein Boolean, der den Suchereignismodus darstellt. Wenntrue, wird bei jedem Tastendruck oder beim Klicken auf die Abbrechen-Schaltfläche ausgelöst; andernfalls wird beim Drücken vonEnter ausgelöst.

labelsSchreibgeschützt

Gibt eine Liste von<label>-Elementen zurück, die Labels für dieses Element sind.

listSchreibgeschützt

Gibt das Element zurück, auf das vomlist-Attribut verwiesen wird. Die Eigenschaft kannnull sein, wenn kein HTML-Element im gleichen Baum gefunden wird.

multiple

Ein Boolean, der dasmultiple-Attribut des Elements darstellt und angibt, ob mehr als ein Wert möglich ist (z. B. mehrere Dateien).

name

Ein String, der dasname-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 Typstype="button" gesteuert wird, ausgeführt werden soll ("hide","show" oder"toggle"). Es spiegelt den Wert despopovertargetaction-HTML-Attributs wider.

popoverTargetElement

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

step

Ein String, der dasstep-Attribut des Elements darstellt, welches mitmin undmax zusammenarbeitet, um die Schritte zu begrenzen, in denen ein Zahlen- oder Datumswert 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 Schrittwertes, die größer als das Minimum sind.

type

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

useMapVeraltet

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

EinDate, der den Wert des Elements als Datum interpretiert darstellt odernull, 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 oderNaN, wenn die Umwandlung unmöglich ist.

Instanz-Eigenschaften im Zusammenhang mit dem übergeordneten Formular

formSchreibgeschützt

Gibt eine Referenz zum übergeordneten<form>-Element zurück.

formAction

Ein String, der dasformaction-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 dasformenctype-Attribut des Elements darstellt, das den Inhaltstyp enthält, der verwendet wird, um das Formular an den Server zu senden. Dies überschreibt dasenctype-Attribut des übergeordneten Formulars.

formMethod

Ein String, der dasformmethod-Attribut des Elements darstellt, das 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 dasformnovalidate-Attribut des Elements darstellt und angibt, dass das Formular beim Absenden nicht validiert werden soll. Dies überschreibt dasnovalidate-Attribut des übergeordneten Formulars.

formTarget

Ein String, der dasformtarget-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 dastarget-Attribut des übergeordneten Formulars.

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

disabled

Ein Boolean, der dasdisabled-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 auchreadonly.

required

Ein Boolean, der dasrequired-Attribut des Elements darstellt und angibt, dass der Benutzer einen Wert eingeben muss, bevor er ein Formular absenden kann.

validationMessageSchreibgeschü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 ihre Einschränkungen erfüllt. Dieser Wert kann mit dersetCustomValidity()-Methode festgelegt werden.

validitySchreibgeschützt

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

willValidateSchreibgeschützt

Gibt zurück, ob das Element ein Kandidat für die Einschränkungsvalidierung ist. Es istfalse, wenn irgendeine Bedingung es von der Einschränkungsvalidierung ausschließt, einschließlich: Seintype ist einer vonhidden,reset oderbutton, es hat einen<datalist>-Vorfahren oder seinedisabled-Eigenschaft isttrue.

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 deschecked-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 dasalt-Attribut des Elements darstellt, das alternativen Text enthält, der verwendet werden soll.

height

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

src

Ein String, der dassrc-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 daswidth-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 dasaccept-Attribut des Elements darstellt, das eine durch Kommas getrennte Liste von Dateitypen enthält, die ausgewählt werden können.

capture

Ein String, der dascapture-Attribut des Elements darstellt und die Methode der Media-Erfassung in Datei-Upload-Steuerungen angibt.

files

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

webkitdirectory

Ein Boolean, der daswebkitdirectory-Attribut darstellt. Wenntrue, akzeptiert die Dateisystem-Auswahloberfläche nur Verzeichnisse anstelle von Dateien.

webkitEntriesSchreibgeschü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 dasautocomplete-Attribut des Elements darstellt und angibt, ob der Wert der Steuerung automatisch vom Browser vervollständigt werden kann.

max

Ein String, der dasmax-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 dasmaxlength-Attribut des Elements darstellt und die maximale Anzahl von Zeichen (in Unicode-Codepunkten) enthält, die der Wert haben kann.

min

Ein String, der dasmin-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 dasminlength-Attribut des Elements darstellt und die minimale Anzahl von Zeichen (in Unicode-Codepunkten) enthält, die der Wert haben kann.

pattern

Ein String, der daspattern-Attribut des Elements darstellt, das ein reguläres Ausdrucksmuster enthält, gegen das der Wert der Steuerung geprüft wird. Verwenden Sie dastitle-Attribut, um das Muster zu beschreiben und dem Benutzer zu helfen. Dieses Attribut gilt nur, wenn der Wert destype-Attributestext,search,tel,url oderemail ist.

placeholder

Ein String, der dasplaceholder-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 destype-Attributestext,search,tel,url oderemail ist.

readOnly

Ein Boolean, der dasreadonly-Attribut des Elements darstellt und angibt, dass der Benutzer den Wert der Steuerung nicht ändern kann. Dies wird ignoriert, wenn dertypehidden,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) odernone (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 dassize-Attribut des Elements darstellt und die visuelle Größe der Steuerung enthält. Dieser Wert ist in Pixeln, es sei denn, der Wert vontype isttext oderpassword, in welchem Fall es sich um eine ganze Zahl von Zeichen handelt. Gilt nur, wenntype auftext,search,tel,url,email oderpassword gesetzt ist.

Instanz-Methoden

Erbt auch Methoden von seinem Eltern-Interface,HTMLElement.

checkValidity()

Gibt einen Boolean-Wert zurück, derfalse 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 eininvalid-Ereignis am Element aus. Es gibttrue zurück, wenn das Element kein Kandidat für die Einschränkungsvalidierung ist oder es seine Einschränkungen erfüllt.

reportValidity()

Führt die MethodecheckValidity() 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 denvalue um (step * n), wobei n standardmäßig 1 ist, wenn nicht angegeben.

stepUp()

Erhöht denvalue 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 mitaddEventListener() oder indem Sie einen Ereignis-Listener auf dieoneventname-Eigenschaft dieses Interfaces zuweisen:

cancel Ereignis

Wird ausgelöst, wenn der Benutzer den Datei-Auswahldialog über dieEsc-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 EreignisNicht standardisiert

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