ElementInternals: setValidity() Methode
Baseline 2023
Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Die setValidity()
-Methode des ElementInternals
-Interfaces setzt die Gültigkeit des Elements.
Syntax
setValidity(flags)
setValidity(flags, message)
setValidity(flags, message, anchor)
Parameter
flags
Optional-
Ein Wörterbuchobjekt, das ein oder mehrere Flags enthält, die den Gültigkeitszustand des Elements anzeigen:
valueMissing
-
Ein boolescher Wert, der
true
ist, wenn das Element einrequired
-Attribut hat, aber keinen Wert, oderfalse
sonst. Wenntrue
, entspricht das Element der:invalid
CSS-Pseudoklasse. typeMismatch
-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht im erforderlichen Format vorliegt (wenntype
email
oderurl
ist), oderfalse
, wenn das Format korrekt ist. Wenntrue
, entspricht das Element der:invalid
CSS-Pseudoklasse. patternMismatch
-
Ein boolescher Wert, der
true
ist, wenn der Wert nicht dem angegebenenpattern
entspricht, undfalse
, wenn er übereinstimmt. Wenntrue
, entspricht das Element der:invalid
CSS-Pseudoklasse. tooLong
-
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. Wenntrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. tooShort
-
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 minimalen Länge ist. Wenntrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. rangeUnderflow
-
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 CSS-Pseudoklassen:invalid
und:out-of-range
. rangeOverflow
-
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 CSS-Pseudoklassen:invalid
und:out-of-range
. stepMismatch
-
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 die Schrittregel erfüllt. Wenntrue
, entspricht das Element den CSS-Pseudoklassen:invalid
und:out-of-range
. badInput
-
Ein boolescher Wert, der
true
ist, wenn der Benutzer eine Eingabe gemacht hat, die der Browser nicht umwandeln kann. customError
-
Ein boolescher Wert, der angibt, ob die benutzerdefinierte Gültigkeitsnachricht des Elements durch Aufrufen der Methode
setCustomValidity()
auf einen nicht-leeren String gesetzt wurde.
Hinweis: Um alle Flags auf
false
zu setzen, was anzeigt, dass dieses Element alle Einschränkungen der Validierung besteht, übergeben Sie ein leeres Objekt{}
. In diesem Fall müssen Sie keinemessage
übergeben. message
Optional-
Ein String, der eine Nachricht enthält, die gesetzt wird, wenn eines der
flags
true
ist. Dieser Parameter ist nur optional, wenn alleflags
false
sind. anchor
Optional-
Ein
HTMLElement
, das vom Nutzeragenten verwendet werden kann, um Probleme mit dieser Formularübermittlung zu melden.
Rückgabewert
Keiner (undefined
).
Ausnahmen
NotSupportedError
DOMException
-
Wird ausgelöst, wenn das Element seine
formAssociated
-Eigenschaft nicht auftrue
gesetzt hat. TypeError
-
Wird ausgelöst, wenn eines oder mehrere
flags
true
sind. NotFoundError
DOMException
-
Wird ausgelöst, wenn
anchor
angegeben ist, aber der Anker kein inklusiver Schatten-Nachfahre des Elements ist.
Beispiele
Im folgenden Beispiel wird setValidity
mit einem leeren flags
-Parameter aufgerufen, um anzuzeigen, dass das Element die Validierungsregeln für Einschränkungen erfüllt.
this.internals_.setValidity({});
Im folgenden Beispiel wird setValidity
mit dem Flag valueMissing
auf true
gesetzt aufgerufen. Ein message
-Parameter muss dann ebenfalls übergeben werden, der eine Nachricht enthält.
this.internals_.setValidity({ valueMissing: true }, "my message");
Spezifikationen
Specification |
---|
HTML Standard # dom-elementinternals-setvalidity |
Browser-Kompatibilität
BCD tables only load in the browser