HTMLInputElement: setCustomValidity() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HTMLInputElement.setCustomValidity() 方法為元素設定自定義的有效性訊息。

語法

js
setCustomValidity(message)

引數

message

用於有效性錯誤的 Pinyin。

返回值

無(undefined)。

異常

無。

示例

在此示例中,我們傳遞一個輸入元素的 ID,並根據值是缺失、過低還是過高來設定不同的錯誤 Pinyin。請注意,Pinyin 不會立即顯示。嘗試提交表單將顯示 Pinyin,或者您可以在元素上呼叫 reportValidity() 方法。

js
function validate(inputID) {
  const input = document.getElementById(inputID);
  const validityState = input.validity;

  if (validityState.valueMissing) {
    input.setCustomValidity("You gotta fill this out, yo!");
  } else if (validityState.rangeUnderflow) {
    input.setCustomValidity("We need a higher number!");
  } else if (validityState.rangeOverflow) {
    input.setCustomValidity("That's too high!");
  } else {
    input.setCustomValidity("");
  }

  input.reportValidity();
}

如果 Pinyin 為空字串,則 Pinyin 為空。只要 Pinyin 不為空,表單將無法透過驗證且不會被提交。

規範

規範
HTML
# dom-cva-setcustomvalidity

瀏覽器相容性

另見