ValidityState

基线 广泛可用

此功能已得到良好建立,可在许多设备和浏览器版本上运行。它自 2018 年 12 月.

报告反馈

实例属性

ValidityState 接口表示元素相对于约束验证可能处于的有效性状态。它们共同帮助解释为什么元素的值无效以及它为什么无效。

对于这些布尔属性中的每一个,true 的值表示指定的验证失败原因可能是真的,但valid 属性除外,如果元素的值符合所有约束,则该属性为true

badInput 只读

如果用户提供的输入是浏览器无法转换的,则为true 的布尔值。

customError 只读

一个布尔值,指示元素的自定义有效性消息是否已通过调用元素的 setCustomValidity() 方法设置为非空字符串。

patternMismatch 只读

如果值与指定的 pattern 不匹配,则为true 的布尔值,如果匹配则为false。如果为true,则元素匹配 :invalid CSS 伪类。

rangeOverflow 只读

如果值大于 max 属性指定的最大值,则为true 的布尔值,如果值小于或等于最大值,则为false。如果为true,则元素匹配 :invalid:out-of-range CSS 伪类。

rangeUnderflow 只读

如果值小于 min 属性指定的最小值,则为true 的布尔值,如果值大于或等于最小值,则为false。如果为true,则元素匹配 :invalid:out-of-range CSS 伪类。

stepMismatch 只读

如果值不符合 step 属性确定的规则(即,它不能被步长值整除),则为true 的布尔值,如果符合步长规则,则为false。如果为true,则元素匹配 :invalid CSS 伪类。

tooLong 只读

如果值超过 HTMLInputElementHTMLTextAreaElement 对象指定的maxlength,则为true 的布尔值,如果其长度小于或等于最大长度,则为false注意:在 Gecko 中,此属性永远不会为true,因为元素的值会被阻止长于maxlength如果为true,则元素匹配 :invalid:out-of-range CSS 伪类。

tooShort 只读

如果值未满足 HTMLInputElementHTMLTextAreaElement 对象指定的minlength,则为true 的布尔值,如果其长度大于或等于最小长度,则为false。如果为true,则元素匹配 :invalid:out-of-range CSS 伪类。

typeMismatch 只读

如果值不在所需的语法中(当 typeemailurl 时),则为true 的布尔值,如果语法正确,则为false。如果为true,则元素匹配 :invalid CSS 伪类。

valid 只读

如果元素满足其所有验证约束,因此被视为有效,则为true 的布尔值,如果它不符合任何约束,则为false。如果为true,则元素匹配 :valid CSS 伪类;否则匹配 :invalid CSS 伪类。

valueMissing 只读

规范

如果元素具有 required 属性,但没有值,则为true 的布尔值,否则为false。如果为true,则元素匹配 :invalid CSS 伪类。
规范
# HTML 标准

浏览器兼容性

the-constraint-validation-api:validitystate-3

另请参见