ElementInternals:willValidate 屬性

Baseline 已廣泛支援

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

ElementInternals 介面的只讀屬性 willValidate 返回一個布林值,指示該元素是否是可提交元素並且是 約束驗證 的候選者。

不被視為約束驗證候選者的元素包括那些具有以下屬性的元素:disabledhiddenreadonly,型別為 type=buttontype=reset 的輸入元素,或者任何 <datalist> 元素或具有 <datalist> 元素祖先的元素。

如果元素是約束驗證的候選者,則返回 true,否則返回 false

異常

NotSupportedError DOMException

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

示例

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

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_.willValidate); // true

規範

規範
HTML
# dom-elementinternals-willvalidate

瀏覽器相容性