HTMLObjectElement: validity Eigenschaft

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 validity Eigenschaft der HTMLObjectElement Schnittstelle ist schreibgeschützt und gibt ein ValidityState Objekt zurück, das die Gültigkeitszustände dieses Elements repräsentiert. Auch wenn <object> Elemente niemals Kandidaten für die Einschränkungsvalidierung sind, kann der Gültigkeitszustand dennoch ungültig sein, wenn eine benutzerdefinierte Gültigkeitsnachricht gesetzt wurde.

Wert

Ein ValidityState Objekt.

Beispiele

Das folgende Beispiel demonstriert, dass ein <object> in einem ungültigen Zustand ist, wenn ein customError gesetzt wurde; in diesem Zustand gibt checkValidity() true zurück, während die validity Eigenschaft des validityState false ist.

js
const objectElem = document.getElementById("myObjectElm");
objectElem.setCustomValidity("This object element is invalid.");
const validityState = objectElem.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(objectElem.checkValidity()); // true

Spezifikationen

Specification
HTML Standard
# dom-cva-validity

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch