From 556d28a0b5bcff49528d20995db1de0ab6117712 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Thu, 25 Mar 2021 23:58:30 +0900 Subject: Web/API/ValidityState を更新 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 2020/12/22 時点の英語版に基づき更新 (説明文の内容が英語版と開きがあったので、説明文については全面的に再翻訳) --- files/ja/web/api/validitystate/index.html | 75 +++++++++++++++---------------- 1 file changed, 36 insertions(+), 39 deletions(-) (limited to 'files/ja') diff --git a/files/ja/web/api/validitystate/index.html b/files/ja/web/api/validitystate/index.html index 40f512e57e..03564df464 100644 --- a/files/ja/web/api/validitystate/index.html +++ b/files/ja/web/api/validitystate/index.html @@ -9,76 +9,73 @@ tags: - Interface translation_of: Web/API/ValidityState --- -
{{APIRef("HTML DOM")}} {{gecko_minversion_header("2.0")}}
+
{{APIRef("HTML DOM")}}
-

ValidityState インターフェイスは、制約の検証に関して、要素が持つことになる妥当性の状態を表します。要素の値が不正な場合に、なぜ検証に失敗するのかを知る手がかりにもなります。

+

ValidityState インターフェイスは、制約の検証に関して、要素が取りうる妥当性の状態を表します。要素の値が不正な場合に、なぜ検証に失敗するのかを知る手がかりにもなります。

-

プロパティ

+

プロパティ

-

下記のプロパティはどれも真偽値を返します。true は指定された検証が失敗したことを表します。ただし valid プロパティの true だけは、要素の値が全ての制約に適合していることを表します。

+

下記のプロパティはどれも Boolean を返します。true は指定された検証が失敗したことを表します。ただし valid プロパティの true だけは、要素の値がすべての制約に適合していることを表します。

-
{{domxref("ValidityState.badInput")}} {{ReadOnlyInline}}
-
入力値をブラウザが処理できないことを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.customError")}} {{ReadOnlyInline}}
-
その要素のカスタム検証メッセージが、 setCustomValidity() メソッドによって空文字以外に設定されていることを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.patternMismatch")}} {{ReadOnlyInline}}
-
値が、指定された {{htmlattrxref("pattern", "input")}} と一致しないことを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.rangeOverflow")}} {{ReadOnlyInline}}
-
値が、 {{htmlattrxref("max", "input")}} 属性で指定された最大値を超えていることを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.rangeUnderflow")}} {{ReadOnlyInline}}
-
値が、{{htmlattrxref("min", "input")}} 属性で指定された最小値を下回っていることを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.stepMismatch")}} {{ReadOnlyInline}}
-
値が、{{htmlattrxref("step", "input")}} 属性で決められた規則に合わないことを示す {{jsxref("Boolean")}} です。(つまり、step の値で割り切れないことを表します)
-
{{domxref("ValidityState.tooLong")}} {{ReadOnlyInline}}
-
値が、{{domxref("HTMLInputElement")}} や {{domxref("HTMLTextAreaElement")}} オブジェクトの maxlength を超えていることを示す {{jsxref("Boolean")}} です。
- 注: Gecko では maxlength より長い値はそもそも入力できないので、true になることは決してありません。
-
{{domxref("ValidityState.tooShort")}} {{ReadOnlyInline}}
-
値が、{{domxref("HTMLInputElement")}} や {{domxref("HTMLTextAreaElement")}} オブジェクトの minlength を下回っていることを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.typeMismatch")}} {{ReadOnlyInline}}
-
値が、({{htmlattrxref("type", "input")}} が emailurl の場合に)求められる構文規則に従っていないことを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.valid")}} {{ReadOnlyInline}}
-
要素が全ての制約の検証に適合し、有効であることを示す {{jsxref("Boolean")}} です。
-
{{domxref("ValidityState.valueMissing")}} {{ReadOnlyInline}}
-
{{htmlattrxref("required", "input")}} 属性が指定されているのに要素の値がないことを示す {{jsxref("Boolean")}} です。
+
{{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")}} 属性で決められた規則に合わないこと (つまり、step の値で割り切れないこと) を示し、 false は刻みの規則に合っていることを示します。 true の場合、その要素は CSS の {{cssxref(":invalid")}} および {{cssxref(":out-of-range")}} の各擬似クラスに一致します。
+
{{domxref("ValidityState.tooLong", "tooLong")}} {{ReadOnlyInline}}
+
{{jsxref("Boolean")}} で、 true は値が {{domxref("HTMLInputElement")}} または {{domxref("HTMLTextAreaElement")}} オブジェクトの maxlength で指定された長さを超えていることを示し、 false は長さがその最長値以下であることを示します。 注: 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', 'forms.html#the-constraint-validation-api', 'ValidityState') }}{{ SpecName('HTML WHATWG', 'form-control-infrastructure.html#validitystate', 'ValidityState') }} {{Spec2('HTML WHATWG')}} 現行の標準
{{ SpecName('HTML5.1', '#the-constraint-validation-api', 'ValidityState') }}{{ SpecName('HTML5.1', 'sec-forms.html#validitystate-validitystate', 'ValidityState') }} {{Spec2('HTML5.1')}} 前回のスナップショット {{SpecName('HTML5 W3C')}} から変更なし
{{ SpecName('HTML5 W3C', 'forms.html#the-constraint-validation-api', 'ValidityState') }}{{ SpecName('HTML5 W3C', 'forms.html#validitystate', 'ValidityState') }} {{Spec2('HTML5 W3C')}} このインターフェイスを含む {{SpecName('HTML WHATWG')}} の最初のスナップショット
-

ブラウザー実装状況

- - +

ブラウザーの互換性

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

-

関連情報

+

関連情報

-- cgit v1.2.3-54-g00ecf