ValidityState
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.
Das ValidityState
-Interface repräsentiert die Gültigkeitszustände, in denen sich ein Element in Bezug auf die Einschränkungsvalidierung befinden kann. Zusammen helfen sie zu erklären, warum der Wert eines Elements ungültig ist, wenn er die Validierung nicht besteht.
Instanz-Eigenschaften
Für jede dieser booleschen Eigenschaften zeigt ein Wert von true
an, dass der angegebene Grund, warum die Validierung fehlgeschlagen sein könnte, zutrifft, mit Ausnahme der valid
-Eigenschaft, die true
ist, wenn der Wert des Elements allen Einschränkungen entspricht.
badInput
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Benutzer eine Eingabe bereitgestellt hat, die der Browser nicht konvertieren kann. customError
Schreibgeschützt-
Ein boolescher Wert, der anzeigt, ob die benutzerdefinierte Fehlermeldung des Elements durch Aufrufen der
setCustomValidity()
-Methode auf eine nicht-leere Zeichenkette gesetzt wurde. patternMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht dem angegebenenpattern
entspricht, undfalse
, wenn er übereinstimmt. Ist ertrue
, entspricht das Element der CSS-Pseudoklasse:invalid
. rangeOverflow
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert größer ist als das Maximum, das durch dasmax
-Attribut festgelegt ist, oderfalse
, wenn er kleiner oder gleich dem Maximum ist. Ist ertrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. rangeUnderflow
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert kleiner ist als das durch dasmin
-Attribut festgelegte Minimum, oderfalse
, wenn er größer oder gleich dem Minimum ist. Ist ertrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. stepMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht den durch dasstep
-Attribut bestimmten Regeln entspricht (d.h. er ist nicht gleichmäßig durch den Schrittwert teilbar), oderfalse
, wenn er den Schrittregeln entspricht. Ist ertrue
, entspricht das Element der CSS-Pseudoklasse:invalid
. tooLong
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert die fürHTMLInputElement
oderHTMLTextAreaElement
-Objekte festgelegtemaxlength
überschreitet, oderfalse
, wenn seine Länge kleiner oder gleich der maximalen Länge ist. Hinweis: Diese Eigenschaft ist in Gecko niemalstrue
, da die Werte der Elemente daran gehindert werden, länger alsmaxlength
zu sein. Ist ertrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. tooShort
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht die fürHTMLInputElement
oderHTMLTextAreaElement
-Objekte festgelegteminlength
erfüllt, oderfalse
, wenn seine Länge größer oder gleich der Mindestlänge ist. Ist ertrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. typeMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht in der erforderlichen Syntax ist (wenntype
email
oderurl
ist), oderfalse
, wenn die Syntax korrekt ist. Ist ertrue
, entspricht das Element der CSS-Pseudoklasse:invalid
. valid
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn das Element alle seine Validierungsbeschränkungen erfüllt und daher als gültig betrachtet wird, oderfalse
, wenn es eine Einschränkung nicht erfüllt. Ist ertrue
, entspricht das Element der CSS-Pseudoklasse:valid
; andernfalls der CSS-Pseudoklasse:invalid
. valueMissing
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn das Element einrequired
-Attribut hat, aber keinen Wert, oderfalse
anders. Ist ertrue
, entspricht das Element der CSS-Pseudoklasse:invalid
.
Spezifikationen
Specification |
---|
HTML # the-constraint-validation-api:validitystate-3 |