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

浏览器兼容性

另见