WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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