JavaScript Validation API

约束验证 DOM 的方法和属性

方法

方法 描述
checkValidity() 如果 input 元素包含有效数据，则返回 true。
setCustomValidity() 设置 input 元素的 validationMessage 属性。

属性

属性 描述
validity 包含与 input 元素的有效性相关的布尔属性。
validationMessage 包含当有效性为假时浏览器将显示的消息。
willValidate 指示是否将验证 input 元素。

实例 - checkValidity() 方法

如果输入字段包含无效数据，则显示一条消息：

<input id="id1" type="number" min="100" max="300" required>
<button onclick="myFunction()">OK</button>

<p id="demo"></p>

<script>
function myFunction() {
  const inpObj = document.getElementById("id1");
  if (!inpObj.checkValidity()) {
    document.getElementById("demo").innerHTML = inpObj.validationMessage;
  }
}
</script>

亲自试一试

有效性属性

input 元素的有效性属性包含许多与数据有效性相关的属性：

属性 描述
customError 如果设置了自定义的有效性消息，则设置为 true。
patternMismatch 如果元素的值与其 pattern 属性不匹配，则设置为 true。
rangeOverflow 如果元素的值大于其 max 属性，则设置为 true。
rangeUnderflow 如果元素的值小于其 min 属性，则设置为 true。
stepMismatch 如果元素的值根据其 step 属性无效，则设置为 true。
tooLong 如果元素的值超过其 maxLength 属性，则设置为 true。
typeMismatch 如果元素的值根据其 type 属性无效，则设置为 true。
valueMissing 如果元素（带有 required 属性）没有值，则设置为 true。
valid 如果元素的值有效，则设置为 true。

实例

rangeOverflow 属性

如果 input 字段中的数字大于 100（input 的 max 属性），则显示一条消息：

<input id="id1" type="number" max="100">
<button onclick="myFunction()">OK</button>

<p id="demo"></p>

<script>
function myFunction() {
  let text = "Value OK";
  if (document.getElementById("id1").validity.rangeOverflow) {
    text = "Value too large";
  }
}
</script>

亲自试一试

rangeUnderflow 属性

如果 input 字段中的数字大于 100（input 的 max 属性），则显示一条消息：

<input id="id1" type="number" min="100">
<button onclick="myFunction()">OK</button>

<p id="demo"></p>

<script>
function myFunction() {
  let text = = "Value OK";
  if (document.getElementById("id1").validity.rangeUnderflow) {
    text = "Value too small";
  }
}
</script>

亲自试一试