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 im Hinblick auf die Einschränkungsvalidierung befinden kann. Zusammen helfen sie zu erklären, warum der Wert eines Elements die Validierung nicht besteht, falls es ungültig ist.
Instanz-Eigenschaften
Für jede dieser booleschen Eigenschaften zeigt ein Wert von true
an, dass der angegebene Grund der Validierung fehlschlagen könnte, mit der 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 vom Browser nicht konvertiert werden kann. customError
Schreibgeschützt-
Ein boolescher Wert, der anzeigt, ob die benutzerdefinierte Fehlernachricht des Elements durch einen Aufruf der Methode
setCustomValidity()
auf einen nicht-leeren String gesetzt wurde. patternMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht dem angegebenenpattern
entspricht, undfalse
, wenn er dies tut. Wenntrue
, entspricht das Element der:invalid
-CSS-Pseudoklasse. rangeOverflow
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert größer als das durch dasmax
-Attribut angegebene Maximum ist, oderfalse
, wenn er kleiner oder gleich dem Maximum ist. Wenntrue
, entspricht das Element den:invalid
und:out-of-range
-CSS-Pseudoklassen. rangeUnderflow
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert kleiner als das durch dasmin
-Attribut angegebene Minimum ist, oderfalse
, wenn er größer oder gleich dem Minimum ist. Wenntrue
, entspricht das Element den:invalid
und:out-of-range
-CSS-Pseudoklassen. stepMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht den durch dasstep
-Attribut festgelegten Regeln entspricht (das heißt, er ist nicht gleichmäßig durch den Schrittwert teilbar), oderfalse
, wenn er den Schrittregeln entspricht. Wenntrue
, entspricht das Element der:invalid
-CSS-Pseudoklasse. tooLong
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert die angegebenemaxlength
fürHTMLInputElement
oderHTMLTextAreaElement
-Objekte überschreitet, oderfalse
, wenn seine Länge kleiner oder gleich der maximalen Länge ist. Hinweis: Diese Eigenschaft ist in Gecko nietrue
, da die Werte von Elementen daran gehindert werden, länger alsmaxlength
zu sein. Wenntrue
, entspricht das Element den:invalid
und:out-of-range
-CSS-Pseudoklassen. tooShort
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert die angegebeneminlength
fürHTMLInputElement
oderHTMLTextAreaElement
-Objekte nicht erfüllt, oderfalse
, wenn seine Länge größer oder gleich der Mindestlänge ist. Wenntrue
, entspricht das Element den:invalid
und:out-of-range
-CSS-Pseudoklassen. typeMismatch
Schreibgeschützt-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht in der erforderlichen Syntax vorliegt (wenn dertype
email
oderurl
ist), oderfalse
, wenn die Syntax korrekt ist. Wenntrue
, 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. Wenntrue
, 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
anderweitig. Wenntrue
, 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