ElementInternals：validity 属性

基线 2023

新可用

自 2023 年 3 月起，此功能在最新的设备和浏览器版本上均可使用。此功能可能在较旧的设备或浏览器上无法使用。

validity 是 ElementInternals 接口的只读属性，它返回一个 ValidityState 对象，该对象表示元素在约束验证方面可能处于的不同有效性状态。

值

一个 ValidityState 对象。

异常

NotSupportedError DOMException

如果元素的 formAssociated 属性未设置为 true，则抛出此异常。

示例

以下示例显示了一个自定义复选框组件，其中 formAssociated 设置为 true，validity.valid 的值被记录到控制台。

js
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_.validity.valid);

规范

规范
HTML 标准
# dom-elementinternals-validity

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。