HTML DOM
DOM 接口 ValidityState 代表一个元素可有的有效性状态(validity states),其与约束验证(constraint validation)相关。这些状态一起解释了当元素值无效时,它的值为什么不能通过验证。
属性
对于以下每一个布尔值属性来说,值为 true 表示这就是验证失败的特定原因之一;valid 属性是例外,它为 true 表示元素值满足所有的约束条件。
- ValidityState.badInput
- : 一个 Boolean,
true表示用户提供了浏览器不能转换的输入。
- : 一个 Boolean,
- customError
- : 一个 Boolean,表示这个元素的自定义验证信息是否已通过调用元素的 HTMLObjectElement.setCustomValidity 方法设置为一个非空字符串。
- ValidityState.patternMismatch
- : 一个 Boolean,
true表示元素值不匹配规定的pattern,false则表示匹配。true的时候元素可用 CSS 伪类 :invalid 匹配。
- : 一个 Boolean,
- ValidityState.rangeOverflow
- : 一个 Boolean,
true表示值已超过max属性规定的最大值,false则表示小于或等于这个最大值。true的时候元素可用 CSS 伪类 :invalid 和 :out-of-range 匹配。
- : 一个 Boolean,
- ValidityState.rangeUnderflow
- : 一个 Boolean,
true表示值小于min属性规定的最小值,false则表示大于或等于这个最小值。true的时候元素可用 CSS 伪类 :invalid 和 :out-of-range 匹配。
- : 一个 Boolean,
- ValidityState.stepMismatch
- : 一个 Boolean,
true表示值不符合由step属性规定的规则(即该值不能被步长值除尽,译注:假设最小值是 0)。false表示其符合步长值规则。true的时候元素可用 CSS 伪类 :invalid 和 :out-of-range 匹配。
- : 一个 Boolean,
- ValidityState.tooLong
- : 一个 Boolean,
true表示值超过了HTMLInputElement 或 HTMLTextAreaElement 对象中规定的maxlength,false表示值的长度小于或等于最大长度。注意:这个属性在 Gecko 中永远不会是true,因为元素值不允许比maxlength长。true的时候元素可用 CSS 伪类 :invalid 和 :out-of-range 匹配。
- : 一个 Boolean,
- ValidityState.tooShort
- : 一个 Boolean,
true表示值的长度小于 HTMLInputElement 或 HTMLTextAreaElement 对象中规定的minlength,false表示值的长度大于或等于最大长度。true的时候元素可用 CSS 伪类 :invalid 和 :out-of-range 匹配。
- : 一个 Boolean,
- ValidityState.typeMismatch
- : 一个 Boolean,
true表示元素值不满足所需的格式(可见于type是email或url时),false表示格式正确。true的时候元素可用 CSS 伪类 :invalid 匹配。
- : 一个 Boolean,
- valid
- : 一个 Boolean,
true表示元素满足所有的验证约束,因此被认为时有效的,false表示有任一约束不满足。true的时候元素可用 CSS 伪类 :valid 匹配,否则可用 CSS 伪类 :invalid 匹配。
- : 一个 Boolean,
- ValidityState.valueMissing
- : 一个 Boolean,
true表示元素拥有required属性,但没有值,否则为false。true的时候元素可用 CSS 伪类 :invalid 匹配。
- : 一个 Boolean,
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
