Merge branch 'main' into zh-CN/max-translation

files/ja/web/api/htmlinputelement/index.md

@@ -2,7 +2,7 @@
 title: HTMLInputElement
 slug: Web/API/HTMLInputElement
 l10n:
-  sourceCommit: 562fa094ba46f4b118daf30321820dbf13800eba
+  sourceCommit: 050bcdba594e759c0a4dde172de5d334f5a3b20f
 ---
 
 {{APIRef("HTML DOM")}}
@@ -162,6 +162,10 @@ _親インターフェイスである {{domxref("HTMLElement")}} から継承し
 
   - : 文字列で、サーバーが受け入れるファイル形式をカンマ区切りのリストで表すこの要素の [`accept`](/ja/docs/Web/HTML/Element/input#accept) 属性を表します。
 
+- {{domxref("HTMLInputElement.capture", "capture")}}
+
+  - : 文字列で、この要素の [`capture`](/ja/docs/Web/HTML/Element/input#capture) 属性を表し、ファイルアップロードコントロール内でメディアキャプチャの入力方法を示します。
+
 - {{domxref("HTMLInputElement.files", "files")}}
 
   - : {{domxref("FileList")}} で、アップロードするために選択されたファイルのリストを表します。
@@ -179,10 +183,6 @@ _親インターフェイスである {{domxref("HTMLElement")}} から継承し
 
   - : 文字列で、この要素の [`autocomplete`](/ja/docs/Web/HTML/Element/input#autocomplete) 属性を表します。これはコントロールの値をブラウザーで自動的に補完できるかどうかを示します。
 
-- {{domxref("HTMLInputElement.capture", "capture")}}
-
-  - : 文字列で、この要素の [`capture`](/ja/docs/Web/HTML/Element/input#capture) 属性を表し、ファイルアップロードコントロール内でメディアキャプチャの入力方法を示します。
-
 - {{domxref("HTMLInputElement.max", "max")}}
 
   - : 文字列で、この要素の [`max`](/ja/docs/Web/HTML/Element/input#max) 属性を表します。この属性には、この項目の（数値または日時の）最大値が含まれ、最小値（[`min`](/ja/docs/Web/HTML/Element/input#min) 属性）より小さくすることはできません。

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")}} 擬似クラス

files/ja/web/api/htmlselectelement/labels/index.md

@@ -6,7 +6,7 @@ l10n:
   sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3
 ---
 
-{{ APIRef("HTML DOM") }}
+{{APIRef("DOM")}}
 
 **`HTMLSelectElement.labels`** は読み取り専用のプロパティで、この {{HTMLElement("select")}} 要素に関連付けられた {{HTMLElement("label")}} 要素の {{domxref("NodeList")}} を返します。
 
@@ -33,7 +33,7 @@ l10n:
 window.addEventListener("DOMContentLoaded", () => {
   const select = document.getElementById("test");
   for (const label of select.labels) {
-    console.log(label.textContent); // "Label 1" and "Label 2"
+    console.log(label.textContent); // "ラベル 1" と "ラベル 2"
   }
 });
 ```

files/ja/web/api/htmlselectelement/name/index.md

@@ -0,0 +1,37 @@
+---
+title: "HTMLSelectElement: name プロパティ"
+short-title: name
+slug: Web/API/HTMLSelectElement/name
+l10n:
+  sourceCommit: d064784c78ec30c87ec3c3d9681b147999fd782f
+---
+
+{{ApiRef("HTML DOM")}}
+
+**`name`** は {{domxref("HTMLSelectElement")}} インターフェイスのプロパティで、この{{HTMLElement("select")}} 要素の名前を示します。これは、この要素の [`name`](/ja/docs/Web/HTML/Element/select#name) 属性を反映します。
+
+## 値
+
+この要素の名前を表す文字列です。
+
+## 例
+
+```js
+const selectElement = document.querySelector("#planets");
+console.log(`Element's name: ${selectElement.name}`);
+selectElement.name = "galaxies"; // 要素の名前を設定または更新
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("HTMLSelectElement.value")}}
+- {{domxref("HTMLSelectElement.selectedIndex")}}
+- {{domxref("HTMLSelectElement.options")}}

files/ja/web/api/htmlselectelement/showpicker/index.md

@@ -0,0 +1,106 @@
+---
+title: "HTMLSelectElement: showPicker() メソッド"
+short-title: showPicker()
+slug: Web/API/HTMLSelectElement/showPicker
+l10n:
+  sourceCommit: fc763b932ad89104bcf06e3886d014a8485ad7d8
+---
+
+{{ APIRef("HTML DOM") }}
+
+**`HTMLSelectElement.showPicker()`** メソッドは、`select` 要素のブラウザーピッカーを表示します。
+
+これは、通常、要素が選択された際に表示されるものと同じピッカーですが、ボタンを押すなど、他のユーザー操作から発生します。
+
+## 構文
+
+```js-nolint
+showPicker()
+```
+
+### 引数
+
+なし。
+
+### 返値
+
+なし ({{jsxref("undefined")}})。
+
+### 例外
+
+- `InvalidStateError` {{domxref("DOMException")}}
+  - : 要素が変更可能なものでない場合に発生します。つまり、ユーザーが変更できない、あるいは自動的に事前入力できないということです。
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : ユーザー操作（タッチジェスチャーやマウスクリックなど）によって明示的に開始されない場合、発生します（ピッカーには{{Glossary("Transient activation", "一時的な有効か")}}が要求されます）。
+- `NotSupportedError` {{domxref("DOMException")}}
+  - : ピッカーに関連付けられた要素がレンダリングされていない場合に発生します。
+- `SecurityError` {{domxref("DOMException")}}
+  - : オリジンをまたいで iframe で呼び出された場合に発生します。
+
+## セキュリティの注意事項
+
+[一時的なユーザーの活性化](/ja/docs/Web/Security/User_activation)が要求されます。
+この機能が動作するには、ユーザーがページまたはUIの要素と対話する必要があります。
+
+このメソッドは、同一オリジン iframe でのみ呼び出すことができます。別オリジンの iframe で呼び出された場合は例外が発生します。
+
+## 例
+
+### 機能検出
+
+下記コードは、`showPicker()` が対応しているかどうかを調べる方法を示しています。
+
+```js
+if ("showPicker" in HTMLSelectElement.prototype) {
+  // showPicker() is supported.
+}
+```
+
+### ピッカーの起動
+
+この例では、ボタンを使用して、2 つのオプションを持つ `<select>` 要素のピッカーを起動する方法を示しています。
+
+#### HTML
+
+```html
+<p>
+  <select>
+    <option value="1">One</option>
+    <option value="2">Two</option>
+  </select>
+  <button type="button">Show Picker</button>
+</p>
+```
+
+#### JavaScript
+
+コードは `<button>` を取得し、その `click` イベントの待ち受けを追加します。
+イベントハンドラーは `<select>` 要素を取得し、その `showPicker()` を呼び出します。
+
+```js
+const button = document.querySelector("button");
+button.addEventListener("click", (event) => {
+  const select = event.srcElement.previousElementSibling;
+  try {
+    select.showPicker();
+  } catch (error) {
+    window.alert(error);
+  }
+});
+```
+
+<!-- A live example cannot be shown here because they run in a cross-origin frame, and would cause a SecurityError -->
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{ HTMLElement("select") }}
+- {{ domxref("HTMLSelectElement") }}
+- {{ domxref("HTMLInputElement.showPicker()") }}

files/ja/web/api/htmlselectelement/validationmessage/index.md

@@ -0,0 +1,45 @@
+---
+title: "HTMLSelectElement: validationMessage プロパティ"
+short-title: validationMessage
+slug: Web/API/HTMLSelectElement/validationMessage
+l10n:
+  sourceCommit: 7c9ce43e847882874a25590bdde696ebc26d9797
+---
+
+{{APIRef("HTML DOM")}}
+
+**`validationMessage`** は {{domxref("HTMLSelectElement")}} インターフェイスの読み取り専用プロパティで、{{htmlelement("select")}} コントロールが満たさない（もしあれば）検証制約を記述したローカライズされたメッセージを表す文字列を返します。これは、コントロールが制約検証の対象ではない場合（{{domxref("HTMLSelectElement.willValidate")}} が `false` の場合）、または制約を満たしている場合は空文字列となります。
+
+もし、この `<select>` 要素が制約の検証対象（`willValidate` が `true`）であり、制約が満たされていない場合（{{domxref("HTMLSelectElement.validity")}} オブジェクトの `valid` プロパティが `false`）、値は検証中にユーザーに表示されるエラーメッセージとなります。
+
+## 値
+
+文字列です。
+
+## 例
+
+```js
+const select = document.getElementById("mySelect");
+const errorMessage = select.validationMessage;
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{HTMLelement("select")}}
+- {{domxref("HTMLSelectElement")}}
+- {{domxref("HTMLSelectElement.willValidate")}}
+- {{domxref("HTMLSelectElement.validity")}}
+- {{domxref("HTMLSelectElement.checkValidity()")}}
+- {{domxref("HTMLSelectElement.reportValidity()")}}
+- {{domxref("HTMLSelectElement.setCustomValidity()")}}
+- [学習: クライアント側フォーム検証](/ja/docs/Learn/Forms/Form_validation)
+- [ガイド: 制約検証](/ja/docs/Web/HTML/Constraint_validation)
+- CSS {{cssxref(":valid")}} および {{cssxref(":invalid")}} 擬似クラス

files/ja/web/api/htmlselectelement/validity/index.md

@@ -0,0 +1,43 @@
+---
+title: "HTMLSelectElement: validity プロパティ"
+short-title: validity
+slug: Web/API/HTMLSelectElement/validity
+l10n:
+  sourceCommit: 2b29051262aa05ce9a630d0dd2d6958f493abe19
+---
+
+{{APIRef("HTML DOM")}}
+
+**`validity`** は {{domxref("HTMLSelectElement")}} インターフェイスの読み取り専用プロパティは、この要素の有効状態を表す {{domxref("ValidityState")}} オブジェクトを返します。
+
+## 値
+
+{{domxref("ValidityState")}} オブジェクトです。
+
+## 例
+
+次の例では、選択要素の妥当性状態を取得し、妥当でない場合は処理します。
+
+```js
+const select = document.getElementById("mySelect");
+const validityState = select.validity;
+if (!validityState.valid) {
+  // それぞれの妥当性状態を検査
+}
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("HTMLSelectElement.checkValidity()")}}
+- {{HTMLElement("select")}}
+- {{HTMLElement("form")}}
+- [学習: クライアント側フォーム検証](/ja/docs/Learn/Forms/Form_validation)
+- [ガイド: 制約検証](/ja/docs/Web/HTML/Constraint_validation)

files/ja/web/api/htmlselectelement/willvalidate/index.md

@@ -0,0 +1,31 @@
+---
+title: "HTMLSelectElement: willValidate プロパティ"
+short-title: willValidate
+slug: Web/API/HTMLSelectElement/willValidate
+l10n:
+  sourceCommit: 4524e28f0aa5fe3b4da3315c40bbdc8d99653da3
+---
+
+{{APIRef("HTML DOM")}}
+
+**`willValidate`** は {{domxref("HTMLSelectElement")}} インターフェイスの読み取り専用のプロパティで、この {{htmlelement("select")}} 要素が[制約検証](/ja/docs/Web/HTML/Constraint_validation)の対象となる候補であるかどうかを示します。 例えば、{{domxref("HTMLSelectElement.disabled", "disabled")}} プロパティが `true` である場合など、何か制約検証を妨げる条件がある場合は、このプロパティは `false` となります。
+
+## 値
+
+論理値です。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("HTMLSelectElement.checkValidity()")}}
+- {{HTMLElement("select")}}
+- {{HTMLElement("form")}}
+- [学習: クライアント側フォーム検証](/ja/docs/Learn/Forms/Form_validation)
+- [ガイド: 制約検証](/ja/docs/Web/HTML/Constraint_validation)