ElementInternals: validity 屬性

Baseline 已廣泛支援

此功能已成熟，並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來，它已在各種瀏覽器中可用。

ElementInternals 介面的只讀屬性 validity 返回一個 ValidityState 物件，該物件表示元素相對於約束驗證的各種有效性狀態。

值

一個 ValidityState 物件。

異常

NotSupportedError DOMException: 如果元素沒有將其 formAssociated 屬性設定為 true，則丟擲此異常。

示例

以下示例顯示了一個自定義的複選框元件，其中 formAssociated 設定為 true，並將 validity.valid 的值記錄到控制檯。

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

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2023年12月8日，由 MDN 貢獻者進行。

在 GitHub 上檢視此頁面 • 報告此內容的問題