ElementInternals: willValidate property
Baseline 2023Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
- constraint validation.
Elements that are barred from being candidates for constraint validation include those that have the attributes:
disabled
,hidden
orreadonly
, input elements oftype=button
ortype=reset
, or any element that is a<datalist>
element or has a<datalist>
element ancestor.
Value
true
if the element is a candidate for constraint validation, otherwise false
.
Exceptions
NotSupportedError
DOMException
-
Thrown if the element does not have its
formAssociated
property set totrue
.
Examples
The following example shows a custom checkbox component with formAssociated
set to true
, the value of willValidate
is logged to the console.
class CustomCheckbox extends HTMLElement {
static formAssociated = true;
constructor() {
super();
this.internals_ = this.attachInternals();
}
/ …
}
window.customElements.define("custom-checkbox", CustomCheckbox);
let element = document.getElementById("custom-checkbox");
console.log(element.internals_.willValidate); / true
Specifications
Specification |
---|
Product helpwillValidate read-only property of the DOMException \nThrown if the element does not have its The following example shows a custom checkbox component with js
ariaAtomic ariaColCount ariaCurrent ariaHasPopup ariaLevel ariaMultiSelectable ariaPressed ariaRoleDescription ariaRowSpan ariaValueMax form states checkValidity() CustomElementRegistry Element.shadowRoot HTMLElement.attachInternals() Node.isConnected Window.customElements |