diff --git a/files/ja/web/api/htmlselectelement/checkvalidity/index.md b/files/ja/web/api/htmlselectelement/checkvalidity/index.md index e071f9a4295e66..85b9cf014d2aec 100644 --- a/files/ja/web/api/htmlselectelement/checkvalidity/index.md +++ b/files/ja/web/api/htmlselectelement/checkvalidity/index.md @@ -3,12 +3,15 @@ title: "HTMLSelectElement: checkValidity() メソッド" short-title: checkValidity() slug: Web/API/HTMLSelectElement/checkValidity l10n: - sourceCommit: 58269be5547b2e0b5b6f53a4c6eff6b13dfdf9bd + sourceCommit: 89d17a618d9a09519b1a667ecab74c4c40515e8f --- -{{ APIRef("HTML DOM") }} +{{APIRef("HTML DOM")}} -**`HTMLSelectElement.checkValidity()`** メソッドは、その要素に制約が設定されているかどうか、それを満足しているかどうかをチェックします。その要素が制約を満たしていない場合、ブラウザーはキャンセル可能な {{domxref("HTMLSelectElement/invalid_event", "invalid")}} イベントをその要素に送り、`false` を返します。 +**`checkValidity()`** は {{domxref("HTMLSelectElement")}} インターフェイスのメソッドで、その要素が適用された[制約検証](/ja/docs/Web/HTML/Constraint_validation)ルールを満たしているかどうかを示す論理値を返します。false の場合は、メソッドは要素上で {{domxref("HTMLElement/invalid_event", "invalid")}} イベントも発行します。`checkValidity()` には既定でブラウザーの動作が設定されていないため、この `invalid` イベントをキャンセルしても効果はありません。 + +> [!NOTE] +> HTML の {{htmlelement("select")}} 要素で、{{domxref("HTMLSelectElement.validationMessage", "validationMessage")}} が null 以外の値を持つものは不正なものと見なされ、CSS の {{cssxref(":invalid")}} 擬似クラスに一致し、`checkValidity()` が false を返すようになります。 {{domxref("HTMLSelectElement.setCustomValidity()")}} メソッドを使用して、{{domxref("HTMLSelectElement.validationMessage")}} を空文字列に設定すると、{{domxref("HTMLSelectElement.validity", "validity")}} 状態が妥当となります。 ## 構文 @@ -24,6 +27,15 @@ checkValidity() 要素の値に妥当性の問題がなければ `true` を返し、そうでなければ `false` を返します。 +## 例 + +次の例では、`checkValidity()` を呼び出すと `true` または `false` が返ります。 + +```js +const element = document.getElementById("mySelect"); +console.log(element.checkValidity()); +``` + ## 仕様書 {{Specifications}} @@ -34,4 +46,9 @@ checkValidity() ## 関連情報 -- [フォームの検証](/ja/docs/Web/HTML/Constraint_validation) +- {{domxref("HTMLTextAreaElement.reportValidity()")}} +- {{HTMLElement("textarea")}} +- {{HTMLElement("form")}} +- [学習: クライアント側フォーム検証](/ja/docs/Learn/Forms/Form_validation) +- [ガイド: 制約検証](/ja/docs/Web/HTML/Constraint_validation) +- CSS {{cssxref(":valid")}} および {{cssxref(":invalid")}} 擬似クラス