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.
Die ValidityState
-Schnittstelle repräsentiert die Gültigkeitszustände, in denen sich ein Element befinden kann, im Hinblick auf die Einschränkungsvalidierung. Zusammen helfen sie zu erklären, warum der Wert eines Elements nicht gültig ist, wenn er nicht validiert wird.
Instanz-Eigenschaften
Für jede dieser booleschen Eigenschaften zeigt ein Wert von true
an, dass der angegebene Grund für das Scheitern der Validierung zutrifft, mit Ausnahme der valid
-Eigenschaft, die true
ist, wenn der Wert des Elements alle Einschränkungen erfüllt.
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 auf eine nicht-leere Zeichenfolge gesetzt wurde, indem die Methode
setCustomValidity()
des Elements aufgerufen wurde. patternMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht dem angegebenenpattern
entspricht, undfalse
, wenn er es tut. Beitrue
entspricht das Element der:invalid
CSS-Pseudoklasse. rangeOverflow
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert größer ist als das durch dasmax
Attribut festgelegte Maximum, oderfalse
, wenn er kleiner oder gleich dem Maximum ist. Beitrue
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. Beitrue
entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. stepMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht zu den durch dasstep
Attribut festgelegten Regeln passt (d. h., er ist nicht gleichmäßig durch den Schrittwert teilbar), oderfalse
, wenn er zu den Schrittregeln passt. Beitrue
entspricht das Element der:invalid
CSS-Pseudoklasse. tooLong
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert die fürHTMLInputElement
oderHTMLTextAreaElement
Objekte angegebenemaxlength
überschreitet, oderfalse
, wenn seine Länge kleiner oder gleich der maximalen Länge ist. Hinweis: Diese Eigenschaft ist in Gecko niemalstrue
, da die Werte von Elementen daran gehindert werden, länger alsmaxlength
zu sein. Beitrue
entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. tooShort
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert die fürHTMLInputElement
oderHTMLTextAreaElement
Objekte angegebeneminlength
nicht erfüllt, oderfalse
, wenn seine Länge größer oder gleich der Mindestlänge ist. Beitrue
entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. typeMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht der erforderlichen Syntax entspricht (wenntype
email
oderurl
ist), oderfalse
, wenn die Syntax korrekt ist. Beitrue
entspricht das Element der:invalid
CSS-Pseudoklasse. valid
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn das Element alle seine Validierungseinschränkungen erfüllt und daher als gültig angesehen wird, oderfalse
, wenn es eine Einschränkung nicht erfüllt. Beitrue
entspricht das Element der:valid
CSS-Pseudoklasse; andernfalls der:invalid
CSS-Pseudoklasse. valueMissing
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn das Element einrequired
Attribut hat, aber keinen Wert, oderfalse
anders. Beitrue
entspricht das Element der:invalid
CSS-Pseudoklasse.
Spezifikationen
Specification |
---|
HTML Standard # the-constraint-validation-api:validitystate-3 |
Browser-Kompatibilität
BCD tables only load in the browser