From 2754bf34a3882766a6409a14bf1dd089ee955649 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 26 Oct 2024 20:19:32 +0900 Subject: [PATCH] =?UTF-8?q?2024/09/11=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../htmlformelement/checkvalidity/index.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 files/ja/web/api/htmlformelement/checkvalidity/index.md diff --git a/files/ja/web/api/htmlformelement/checkvalidity/index.md b/files/ja/web/api/htmlformelement/checkvalidity/index.md new file mode 100644 index 00000000000000..d61edd80b14ef6 --- /dev/null +++ b/files/ja/web/api/htmlformelement/checkvalidity/index.md @@ -0,0 +1,52 @@ +--- +title: "HTMLFormElement: checkValidity() メソッド" +short-title: checkValidity() +slug: Web/API/HTMLFormElement/checkValidity +l10n: + sourceCommit: 2b29051262aa05ce9a630d0dd2d6958f493abe19 +--- + +{{APIRef("HTML DOM")}} + +**`checkValidity()`** は {{domxref("HTMLFormElement")}} インターフェイスのメソッドで、関連付けられたコントロールすべてが適用された[制約検証](/ja/docs/Web/HTML/Constraint_validation)ルールを満たしているかどうかを示す論理値を返します。 このメソッドは、値が不正な要素にそれぞれ対して {{domxref("HTMLInputElement/invalid_event", "invalid")}} イベントを発行しますが、このフォーム要素自体には発行しません。 `checkValidity()` には既定でブラウザーの動作が設定されていないため、この `invalid` イベントをキャンセルしても効果はありません。 + +> [!NOTE] +> CSS の {{cssxref(":valid")}} および {{cssxref(":invalid")}} 擬似クラスは、`
` 要素自体の妥当性ではなく、 `` 要素に所属するフォームコントロールの妥当性に基づいて適用されます。 + +## 構文 + +```js-nolint +checkValidity() +``` + +### 引数 + +なし。 + +### 返値 + +関連付けられたフォームコントロールの値に妥当性の問題がなければ `true` を返し、そうでなければ `false` を返します。 + +## 例 + +次の例では、`checkValidity()` を呼び出すと、`true` または `false` を返します。 + +```js +const element = document.getElementById("myForm"); +console.log(element.checkValidity()); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{domxref("HTMLFormElement.reportValidity()")}} +- {{HTMLElement("form")}} +- [学習: クライアント側フォーム検証](/ja/docs/Learn/Forms/Form_validation) +- [ガイド: 制約検証](/ja/docs/Web/HTML/Constraint_validation)