ElementInternals: Methode setValidity()

flags Optional

Ein Wörterbuchobjekt, das ein oder mehrere Flags enthält, die den Gültigkeitsstatus des Elements angeben:

valueMissing

Ein boolescher Wert, der true ist, wenn das Element ein required-Attribut hat, aber keinen Wert, oder false sonst. Wenn true, entspricht das Element der :invalid CSS-Pseudoklasse.

typeMismatch

Ein boolescher Wert, der true ist, wenn der Wert nicht in der erforderlichen Syntax vorliegt (wenn type email oder url ist), oder false, wenn die Syntax korrekt ist. Wenn true, entspricht das Element der :invalid CSS-Pseudoklasse.

patternMismatch

Ein boolescher Wert, der true ist, wenn der Wert nicht dem angegebenen pattern entspricht, und false, wenn er es tut. Wenn true, entspricht das Element der :invalid CSS-Pseudoklasse.

tooLong

Ein boolescher Wert, der true ist, wenn der Wert die angegebene maxlength für HTMLInputElement oder HTMLTextAreaElement-Objekte überschreitet, oder false, wenn seine Länge kleiner oder gleich der maximalen Länge ist. Wenn true, entspricht das Element den :invalid und :out-of-range CSS-Pseudoklassen.

tooShort

Ein boolescher Wert, der true ist, wenn der Wert die angegebene minlength für HTMLInputElement oder HTMLTextAreaElement-Objekte nicht erfüllt, oder false, wenn seine Länge größer oder gleich der minimalen Länge ist. Wenn true, entspricht das Element den :invalid und :out-of-range CSS-Pseudoklassen.

rangeUnderflow

Ein boolescher Wert, der true ist, wenn der Wert kleiner ist als das Minimum, das durch das min-Attribut angegeben wird, oder false, wenn er größer oder gleich dem Minimum ist. Wenn true, entspricht das Element den :invalid und :out-of-range CSS-Pseudoklassen.

rangeOverflow

Ein boolescher Wert, der true ist, wenn der Wert größer ist als das Maximum, das durch das max-Attribut angegeben wird, oder false, wenn er kleiner oder gleich dem Maximum ist. Wenn true, entspricht das Element den :invalid und :out-of-range CSS-Pseudoklassen.

stepMismatch

Ein boolescher Wert, der true ist, wenn der Wert nicht den Regeln entspricht, die durch das step-Attribut festgelegt sind (d.h. er ist nicht gleichmäßig durch den Schrittwert teilbar), oder false, wenn er die Schrittregel erfüllt. Wenn true, entspricht das Element den :invalid und :out-of-range CSS-Pseudoklassen.

badInput

Ein boolescher Wert, der true ist, wenn der Benutzer eine Eingabe gemacht hat, die der Browser nicht konvertieren kann.

customError

Ein boolescher Wert, der anzeigt, ob die benutzerdefinierte Gültigkeitsnachricht des Elements durch Aufrufen der Methode setCustomValidity() des Elements auf einen nicht-leeren String gesetzt wurde.

Hinweis: Um alle Flags auf false zu setzen, was anzeigt, dass dieses Element alle Validierungsbeschränkungen erfüllt, übergeben Sie ein leeres Objekt {}. In diesem Fall müssen Sie auch keine message ü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 alle flags false sind.

anchor Optional

Ein HTMLElement, das vom Benutzer-Agenten verwendet werden kann, um Probleme bei dieser Formularübermittlung zu melden.

Keiner (undefined).

NotSupportedError DOMException

Wird ausgelöst, wenn das Element nicht seine formAssociated-Eigenschaft auf true gesetzt hat.

TypeError

Wird ausgelöst, wenn eines oder mehrere flags true ist.

NotFoundError DOMException

Wird ausgelöst, wenn anchor angegeben ist, der Anker aber kein Shadow-inkludierender Nachfahre des Elements ist.

Im folgenden Beispiel wird setValidity mit einem leeren flags-Parameter aufgerufen, um anzuzeigen, dass das Element die Validierungsregeln erfüllt.

this.internals_.setValidity({});

Im folgenden Beispiel wird setValidity mit dem Flag valueMissing auf true aufgerufen. Ein message-Parameter muss dann ebenfalls mit einer Nachricht übergeben werden.

this.internals_.setValidity({ valueMissing: true }, "my message");