From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/validitystate/index.html | 88 ++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 files/zh-cn/web/api/validitystate/index.html (limited to 'files/zh-cn/web/api/validitystate') diff --git a/files/zh-cn/web/api/validitystate/index.html b/files/zh-cn/web/api/validitystate/index.html new file mode 100644 index 0000000000..4fc6e0d3ef --- /dev/null +++ b/files/zh-cn/web/api/validitystate/index.html @@ -0,0 +1,88 @@ +--- +title: ValidityState +slug: Web/API/ValidityState +tags: + - API + - HTML DOM + - 接口 + - 表单 + - 输入 +translation_of: Web/API/ValidityState +--- +
{{APIRef("HTML DOM")}} {{gecko_minversion_header("2.0")}}
+ +

DOM接口 ValidityState 代表一个元素可有的有效性状态（validity states），其与约束验证（constraint validation）相关。这些状态一起解释了当元素值无效时，它的值为什么不能通过验证。

+ +

属性

+ +

对于以下每一个布尔值属性来说，值为 true 表示这就是验证失败的特定原因之一；valid 属性是例外，它为 true 表示元素值满足所有的约束条件。

+ +
+
{{domxref("ValidityState.badInput", "badInput")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示用户提供了浏览器不能转换的输入。
+
customError {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，表示这个元素的自定义验证信息是否已通过调用元素的 {{domxref('HTMLObjectElement.setCustomValidity', 'setCustomValidity()')}} 方法设置为一个非空字符串。
+
+ +
+
{{domxref("ValidityState.patternMismatch", "patternMismatch")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示元素值不匹配规定的{{htmlattrxref("pattern", "input")}}，false 则表示匹配。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 匹配。
+
{{domxref("ValidityState.rangeOverflow", "rangeOverflow")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示值已超过 {{htmlattrxref("max", "input")}} 属性规定的最大值，false 则表示小于或等于这个最大值。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 和 {{cssxref(":out-of-range")}} 匹配。
+
{{domxref("ValidityState.rangeUnderflow", "rangeUnderflow")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示值小于 {{htmlattrxref("min", "input")}} 属性规定的最小值，false 则表示大于或等于这个最小值。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 和 {{cssxref(":out-of-range")}} 匹配。
+
{{domxref("ValidityState.stepMismatch", "stepMismatch")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示值不符合由 {{htmlattrxref("step", "input")}} 属性规定的规则（即该值不能被步长值除尽，译注：假设最小值是0）。false 表示其符合步长值规则。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 和 {{cssxref(":out-of-range")}} 匹配。
+
{{domxref("ValidityState.tooLong", "tooLong")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示值超过了{{domxref("HTMLInputElement")}} 或 {{domxref("HTMLTextAreaElement")}} 对象中规定的 maxlength， false 表示值的长度小于或等于最大长度。注意：This这个属性在Gecko中永远不会是 true，因为元素值不允许比 maxlength 长。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 和 {{cssxref(":out-of-range")}} 匹配。
+
{{domxref("ValidityState.tooShort", "tooShort")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示值的长度小于 {{domxref("HTMLInputElement")}} 或 {{domxref("HTMLTextAreaElement")}} 对象中规定的 minlength， false 表示值的长度大于或等于最大长度。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 和 {{cssxref(":out-of-range")}} 匹配。
+
{{domxref("ValidityState.typeMismatch", "typeMismatch")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示元素值不满足所需的格式（可见于 {{htmlattrxref("type", "input")}} 是 email 或 url 时），false 表示格式正确。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 匹配。
+
valid {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}，true 表示元素满足所有的验证约束，因此被认为时有效的，false 表示有任一约束不满足。true 的时候元素可用 CSS 伪类 {{cssxref(":valid")}} 匹配，否则可用 CSS 伪类 {{cssxref(":invalid")}} 匹配。
+
{{domxref("ValidityState.valueMissing", "valueMissing")}} {{ReadOnlyInline}}
+
一个 {{jsxref("Boolean")}}， true 表示元素拥有 {{htmlattrxref("required", "input")}} 属性，但没有值，否则为 false。true 的时候元素可用 CSS 伪类 {{cssxref(":invalid")}} 匹配。
+
+ +

属性

+ + + + + + + + + + + + + + + + + + + + + + + + +
规范状态注释
{{ SpecName('HTML WHATWG', 'form-control-infrastructure.html#validitystate', 'ValidityState') }}{{Spec2('HTML WHATWG')}}Living Standard
{{ SpecName('HTML5.1', 'sec-forms.html#validitystate-validitystate', 'ValidityState') }}{{Spec2('HTML5.1')}}No change from the previous snapshot {{SpecName('HTML5 W3C')}}.
+

{{ SpecName('HTML5 W3C', 'forms.html#validitystate', 'ValidityState') }}

+ 		{{Spec2('HTML5 W3C')}} +

First snapshot of  {{SpecName('HTML WHATWG')}} containing this interface.

+
+ +

浏览器兼容性

+ +

{{Compat("api.ValidityState")}}

+ +

参见

+ + -- cgit v1.2.3-54-g00ecf