Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Web/API/HTMLSelectElement/checkValidity を更新 #24096

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 21 additions & 4 deletions files/ja/web/api/htmlselectelement/checkvalidity/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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")}} 状態が妥当となります。

## 構文

Expand All @@ -24,6 +27,15 @@ checkValidity()

要素の値に妥当性の問題がなければ `true` を返し、そうでなければ `false` を返します。

## 例

次の例では、`checkValidity()` を呼び出すと `true` または `false` が返ります。

```js
const element = document.getElementById("mySelect");
console.log(element.checkValidity());
```

## 仕様書

{{Specifications}}
Expand All @@ -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")}} 擬似クラス