CKTIS / JavaScript
HTMLInputElement: Eingabetyp, Zustand und Einschränkungen
Lerne sechs Eigenschaften von HTMLInputElement kennen, mit denen sich der Eingabetyp festlegen, der Auswahlzustand auslesen, Einschränkungen setzen und ein Steuerelement deaktivieren lassen. Unterscheide den aktuellen Zustand von Anfangsattributen und eine Validierungsmeldung vom eigentlichen Validierungsergebnis.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement ist die DOM-Schnittstelle des Browsers für Eingabefelder und kein Bestandteil von ECMAScript selbst. type ist eine Zeichenfolge, die den Feldtyp festlegt, etwa text, number oder checkbox; der Typ bestimmt, welche weiteren Einschränkungen gelten. Diese Eigenschaften sind in modernen Browsern weit verbreitet, doch die UI-Unterstützung einzelner Eingabetypen kann variieren. Node 24 allein belegt nicht, dass diese API unterstützt wird.
minLength ist die numerische Entsprechung des Attributs minlength: Es legt die Mindestlänge des Textes in UTF-16-Codeeinheiten fest, nicht unbedingt in vom Nutzer wahrgenommenen Zeichen. -1 bedeutet, dass kein Minimum festgelegt ist. Die Eigenschaft gilt für textähnliche Typen, verlangt ohne required keinen nichtleeren Wert, und die Prüfung auf zu kurzen Text betrifft Eingaben des Nutzers, nicht allein eine Zuweisung durch ein Skript. max ist eine Zeichenfolge wie "10", die für die entsprechenden Typen die Obergrenze für Zahlen, Datumswerte oder Uhrzeiten festlegt; anders als maxLength begrenzt sie nicht die Textlänge. Bei type="time" wiederholen sich die Uhrzeiten im Tageszyklus: Liegt min zeitlich nach max, reicht der zulässige Bereich von min über Mitternacht bis max. Mit min="22:00" und max="02:00" liegt beispielsweise 23:00 im zulässigen Bereich, obwohl es später als max ist.
checked ist ein boolescher Wert für den aktuellen Auswahlzustand eines checkbox- oder radio-Feldes, nicht für dessen Text-value. Das Attribut checked legt den Standardzustand fest, der durch defaultChecked widergespiegelt wird; eine Änderung des aktuellen Auswahlzustands aktualisiert dieses Attribut nicht. disabled spiegelt ein boolesches Attribut wider: Mit true wird die Interaktion verhindert, das Feld von den übermittelten Formulardaten ausgeschlossen und von der Constraint-Validierung ausgenommen. Es ist nicht gleichbedeutend mit readOnly.
validationMessage ist eine schreibgeschützte Zeichenfolge mit einer lokalisierten Fehlermeldung oder "", wenn das Feld seine Einschränkungen erfüllt oder von der Validierung ausgenommen ist. Eine leere Meldung beweist daher nicht, dass ein deaktiviertes Feld einen gültigen Wert hat. Eine eigene Meldung lässt sich mit setCustomValidity() setzen und mit setCustomValidity("") löschen. Das Beispiel prüft, ob die Meldung leer ist, statt sprachabhängigen Wortlaut zu vergleichen, und versucht nicht, einen minLength-Fehler durch eine Skriptzuweisung zu demonstrieren.
In diesem Eintrag behandelte Referenzbezeichner: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Beispiele
(() => {
const text = document.createElement("input");
text.type = "text";
text.minLength = 3;
console.log(text.type, text.minLength);
const box = document.createElement("input");
box.type = "checkbox";
box.checked = true;
console.log(box.checked, box.defaultChecked);
const number = document.createElement("input");
number.type = "number";
number.max = "10";
number.value = "11";
console.log(number.max, number.validity.rangeOverflow);
console.log(number.validationMessage !== "");
number.disabled = true;
console.log(number.disabled, number.willValidate);
console.log(number.validationMessage === "");
})();Ergebnis
text 3 true false 10 true true true false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- HTMLInputElement - Web APIs | MDN
- HTMLInputElement: validationMessage property - Web APIs | MDN
- HTMLInputElement: minLength property - Web APIs | MDN
- HTMLInputElement: type property - Web APIs | MDN
- HTMLInputElement: checked property - Web APIs | MDN
- HTMLInputElement: max property - Web APIs | MDN
- HTMLInputElement: disabled property - Web APIs | MDN
- minlength HTML attribute - HTML | MDN