ValidityState
基线 广泛可用
此功能已得到良好建立,可在许多设备和浏览器版本上运行。它自 2018 年 12 月.
报告反馈
实例属性
ValidityState
接口表示元素相对于约束验证可能处于的有效性状态。它们共同帮助解释为什么元素的值无效以及它为什么无效。
- 对于这些布尔属性中的每一个,
true
的值表示指定的验证失败原因可能是真的,但valid
属性除外,如果元素的值符合所有约束,则该属性为true
。 -
badInput
只读 - 如果用户提供的输入是浏览器无法转换的,则为
true
的布尔值。 -
customError
只读 - 一个布尔值,指示元素的自定义有效性消息是否已通过调用元素的
setCustomValidity()
方法设置为非空字符串。 - 如果值与指定的
pattern
不匹配,则为true
的布尔值,如果匹配则为false
。如果为true
,则元素匹配:invalid
CSS 伪类。 - 如果值大于
max
属性指定的最大值,则为true
的布尔值,如果值小于或等于最大值,则为false
。如果为true
,则元素匹配:invalid
和:out-of-range
CSS 伪类。 - 如果值小于
min
属性指定的最小值,则为true
的布尔值,如果值大于或等于最小值,则为false
。如果为true
,则元素匹配:invalid
和:out-of-range
CSS 伪类。 -
stepMismatch
只读 - 如果值不符合
step
属性确定的规则(即,它不能被步长值整除),则为true
的布尔值,如果符合步长规则,则为false
。如果为true
,则元素匹配:invalid
CSS 伪类。 -
tooLong
只读 - 如果值超过
HTMLInputElement
或HTMLTextAreaElement
对象指定的maxlength
,则为true
的布尔值,如果其长度小于或等于最大长度,则为false
。注意:在 Gecko 中,此属性永远不会为true
,因为元素的值会被阻止长于maxlength
。如果为true
,则元素匹配:invalid
和:out-of-range
CSS 伪类。 -
tooShort
只读 - 如果值未满足
HTMLInputElement
或HTMLTextAreaElement
对象指定的minlength
,则为true
的布尔值,如果其长度大于或等于最小长度,则为false
。如果为true
,则元素匹配:invalid
和:out-of-range
CSS 伪类。 -
typeMismatch
只读 - 如果值不在所需的语法中(当
type
为email
或url
时),则为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