From d0d146aba7294024440a3f6cd9fb6c7e17ba5786 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 21:15:07 +0900
Subject: [PATCH 01/11] =?UTF-8?q?2023/04/07=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=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/htmlselectelement/labels/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/files/ja/web/api/htmlselectelement/labels/index.md b/files/ja/web/api/htmlselectelement/labels/index.md
index 052daac7091020..e826c0e8339b22 100644
--- a/files/ja/web/api/htmlselectelement/labels/index.md
+++ b/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"
   }
 });
 ```

From 17219b86010abf3f58fb00e3d64a8cafe26f70a0 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 21:34:07 +0900
Subject: [PATCH 02/11] =?UTF-8?q?2024/08/29=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

---
 .../web/api/htmlselectelement/name/index.md   | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 files/ja/web/api/htmlselectelement/name/index.md

diff --git a/files/ja/web/api/htmlselectelement/name/index.md b/files/ja/web/api/htmlselectelement/name/index.md
new file mode 100644
index 00000000000000..a3534ebb2c67db
--- /dev/null
+++ b/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")}}

From 5129b76613b3502622fd9d4d530a5dae370fce53 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 21:59:25 +0900
Subject: [PATCH 03/11] =?UTF-8?q?2024/09/20=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

---
 .../validationmessage/index.md                | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 files/ja/web/api/htmlselectelement/validationmessage/index.md

diff --git a/files/ja/web/api/htmlselectelement/validationmessage/index.md b/files/ja/web/api/htmlselectelement/validationmessage/index.md
new file mode 100644
index 00000000000000..2cac4857de09b0
--- /dev/null
+++ b/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")}} 擬似クラス

From 0e712a7d131aebb60e6b53a09e4b27f93028c497 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 22:07:43 +0900
Subject: [PATCH 04/11] =?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

---
 .../api/htmlselectelement/validity/index.md   | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 files/ja/web/api/htmlselectelement/validity/index.md

diff --git a/files/ja/web/api/htmlselectelement/validity/index.md b/files/ja/web/api/htmlselectelement/validity/index.md
new file mode 100644
index 00000000000000..2f8e193ce10d25
--- /dev/null
+++ b/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)

From 62f05c26d36dd51c9d378162c28d4719e6abfdfb Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 22:16:45 +0900
Subject: [PATCH 05/11] =?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

---
 .../htmlselectelement/willvalidate/index.md   | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 files/ja/web/api/htmlselectelement/willvalidate/index.md

diff --git a/files/ja/web/api/htmlselectelement/willvalidate/index.md b/files/ja/web/api/htmlselectelement/willvalidate/index.md
new file mode 100644
index 00000000000000..fc155665ad6575
--- /dev/null
+++ b/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)

From d42fc0a67bbf1ad1dfecc790b8991a7ca8656f52 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 22:52:15 +0900
Subject: [PATCH 06/11] =?UTF-8?q?2024/08/31=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=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../htmlselectelement/checkvalidity/index.md  | 25 ++++++++++++++++---
 1 file changed, 21 insertions(+), 4 deletions(-)

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

From b717299eef094406fabefae50675dd233687d670 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 16 Oct 2024 23:45:00 +0900
Subject: [PATCH 07/11] =?UTF-8?q?2023/12/10=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

---
 .../api/htmlselectelement/showpicker/index.md | 106 ++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 files/ja/web/api/htmlselectelement/showpicker/index.md

diff --git a/files/ja/web/api/htmlselectelement/showpicker/index.md b/files/ja/web/api/htmlselectelement/showpicker/index.md
new file mode 100644
index 00000000000000..acd48ebb9aadb1
--- /dev/null
+++ b/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()") }}

From 7fa2795cab4a93e757679e9c9cbca9ce3cea281f Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Sun, 20 Oct 2024 19:16:20 +0800
Subject: [PATCH 08/11] [zh-CN]: add translation for `KeyboardLayoutMap.has()`
 (#24086)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../web/api/keyboardlayoutmap/has/index.md    | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 files/zh-cn/web/api/keyboardlayoutmap/has/index.md

diff --git a/files/zh-cn/web/api/keyboardlayoutmap/has/index.md b/files/zh-cn/web/api/keyboardlayoutmap/has/index.md
new file mode 100644
index 00000000000000..bc365d6e6738b9
--- /dev/null
+++ b/files/zh-cn/web/api/keyboardlayoutmap/has/index.md
@@ -0,0 +1,51 @@
+---
+title: KeyboardLayoutMap：has() 方法
+slug: Web/API/KeyboardLayoutMap/has
+l10n:
+  sourceCommit: bcb654104082a8d12d51aecfad047d7a4a26116f
+---
+
+{{APIRef("Keyboard API")}}{{SeeCompatTable}}
+
+{{domxref('KeyboardLayoutMap')}} 接口的 **`has()`** 方法返回一个布尔值，指示该对象是否具有指定键的元素。
+
+在 [UI 事件 KeyboardEvent 代码值](https://www.w3.org/TR/uievents-code/#key-alphanumeric-writing-system)规范中可以找到有效键的列表。
+
+该方法与 {{jsxref("Map.prototype.has()")}} 相似。
+
+## 语法
+
+```js-nolint
+has(key)
+```
+
+### 参数
+
+- `key`
+  - : 要在映射中搜索的元素的键。
+
+### 返回值
+
+{{jsxref('Boolean')}} 值，表示是否找到了指定的键。
+
+## 示例
+
+以下示例检查与英语 QWERTY 键盘上“W”键对应的键盘代码关联的位置或布局特定的字符串是否存在。
+
+```js
+navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
+  console.log(keyboardLayoutMap.has("KeyW"));
+});
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{jsxref("Map.prototype.has()")}}

From 3a3936ff8ef9d1424d48454eedac817828dacbcf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=86=9C=E8=8D=AF=E5=90=9B?=
 <99505726+cnbilinyj@users.noreply.github.com>
Date: Sun, 20 Oct 2024 21:52:53 +0800
Subject: [PATCH 09/11] zh-cn: init the translation of the
 `Document.createTouch()` method (#23978)

Co-authored-by: Allo <yin199909@aliyun.com>
---
 .../web/api/document/createtouch/index.md     | 88 +++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 files/zh-cn/web/api/document/createtouch/index.md

diff --git a/files/zh-cn/web/api/document/createtouch/index.md b/files/zh-cn/web/api/document/createtouch/index.md
new file mode 100644
index 00000000000000..87d62e4f0f2fcd
--- /dev/null
+++ b/files/zh-cn/web/api/document/createtouch/index.md
@@ -0,0 +1,88 @@
+---
+title: Document：createTouch() 方法
+slug: Web/API/Document/createTouch
+l10n:
+  sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378
+---
+
+{{APIRef("DOM")}}{{Deprecated_Header}}{{Non-standard_header}}
+
+**`Document.createTouch()`** 方法创建并返回一个新的 {{DOMxRef("Touch")}} 对象。
+
+> [!NOTE]
+> 建议使用 {{domxref("TouchEvent.TouchEvent", "TouchEvent()")}} 构造函数。
+
+## 语法
+
+```js-nolint
+createTouch(view, target, identifier, pageX, pageY, screenX, screenY)
+```
+
+### 语法
+
+> [!NOTE]
+> 所有参数都是可选的。
+
+- `view`
+  - : 发生触摸的 {{DOMxRef("window")}}。
+- `target`
+  - : 触摸的 {{DOMxRef("EventTarget")}}。
+- `identifier`
+  - : {{DOMxRef("Touch.identifier")}} 的值。
+- `pageX`
+  - : {{DOMxRef("Touch.pageX")}} 的值。
+- `pageY`
+  - : {{DOMxRef("Touch.pageY")}} 的值。
+- `screenX`
+  - : {{DOMxRef("Touch.screenX")}} 的值。
+- `screenY`
+  - : {{DOMxRef("Touch.screenY")}} 的值。
+
+> [!NOTE]
+> 该方法的先前版本包括以下附加参数，但这些参数未包含在下面列出的任何标准中。因此，这些参数应被视为已弃用且不应再被使用。
+
+- `clientX`
+  - : {{DOMxRef("Touch.clientX")}} 的值。
+- `clientY`
+  - : {{DOMxRef("Touch.clientY")}} 的值。
+- `radiusX`
+  - : {{DOMxRef("Touch.radiusX")}} 的值。
+- `radiusY`
+  - : {{DOMxRef("Touch.radiusY")}} 的值。
+- `rotationAngle`
+  - : {{DOMxRef("Touch.rotationAngle")}} 的值。
+- `force`
+  - : {{DOMxRef("Touch.force")}} 的值。
+
+### 返回值
+
+- `touch`
+  - : 按照输入参数的描述配置的 {{DOMxRef("Touch")}} 对象。
+
+## 示例
+
+此示例说明了如何使用 `Document.createTouch()` 方法创建 {{DOMxRef("Touch")}} 对象。
+
+在下面的代码片段中，为 `target` 元素创建了两个 {{DOMxRef("Touch")}} 对象。
+
+```js
+const target = document.getElementById("target");
+
+const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
+const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);
+```
+
+## 规范
+
+此特性属于任何当前的规范。它不再有望成为标准。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- [触摸事件](/zh-CN/docs/Web/API/Touch_events)
+- {{DOMxRef("TouchList")}}
+- {{DOMxRef("Touch")}}
+- {{DOMxRef("Document.createTouchList()")}}

From e2ecb5847e5c3d770db5f66c53e0ebb93437c51d Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Thu, 17 Oct 2024 00:50:06 +0900
Subject: [PATCH 10/11] =?UTF-8?q?2024/09/13=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=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/htmlinputelement/index.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/files/ja/web/api/htmlinputelement/index.md b/files/ja/web/api/htmlinputelement/index.md
index 972ccb7898e51b..5a169a7f9d8e8b 100644
--- a/files/ja/web/api/htmlinputelement/index.md
+++ b/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) 属性）より小さくすることはできません。

From 861008bae2c38fb3d8af29a9231525d034a389f8 Mon Sep 17 00:00:00 2001
From: Chunhui Fu <fuchuhu7@gmail.com>
Date: Mon, 21 Oct 2024 14:21:18 +0800
Subject: [PATCH 11/11] [zh-cn]: create docs for HTMLFontElement (#24100)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../web/api/htmlfontelement/color/index.md    | 44 +++++++++++++
 .../web/api/htmlfontelement/face/index.md     | 42 +++++++++++++
 files/zh-cn/web/api/htmlfontelement/index.md  | 39 ++++++++++++
 .../web/api/htmlfontelement/size/index.md     | 62 +++++++++++++++++++
 4 files changed, 187 insertions(+)
 create mode 100644 files/zh-cn/web/api/htmlfontelement/color/index.md
 create mode 100644 files/zh-cn/web/api/htmlfontelement/face/index.md
 create mode 100644 files/zh-cn/web/api/htmlfontelement/index.md
 create mode 100644 files/zh-cn/web/api/htmlfontelement/size/index.md

diff --git a/files/zh-cn/web/api/htmlfontelement/color/index.md b/files/zh-cn/web/api/htmlfontelement/color/index.md
new file mode 100644
index 00000000000000..5393e8e3470ce6
--- /dev/null
+++ b/files/zh-cn/web/api/htmlfontelement/color/index.md
@@ -0,0 +1,44 @@
+---
+title: HTMLFontElement：color 属性
+slug: Web/API/HTMLFontElement/color
+l10n:
+  sourceCommit: 729754108952e0bac9fb6268fcdf24a63b3cbbf3
+---
+
+{{deprecated_header}}{{APIRef("HTML DOM")}}
+
+已过时的 **`HTMLFontElement.color`** 属性是一个反映 [`color`](/zh-CN/docs/Web/HTML/Element/font#color) HTML 属性的字符串，包含命名颜色或以十六进制 #RRGGBB 格式指定的颜色。
+
+字符串的格式必须遵循以下 HTML 微语法（参见 [`<color>`](/zh-CN/docs/Web/CSS/color_value)）之一：
+
+| 微语法                   | 描述                              | 示例                      |
+| ------------------------ | --------------------------------- | ------------------------- |
+| 有效的命名颜色字符串     | _颜色命名（大小写不敏感）_        | `Green`、`green`、`GREEN` |
+| 有效的十六进制颜色字符串 | _#RRGGBB_                         | `#008000`                 |
+| 使用十进制的 RGB         | _rgb(x x x)（x 在 0-255 范围内）_ | `rgb(0 128 0)`            |
+
+## 值
+
+一个字符串。
+
+当设置为 `null` 时，`null` 值会被转化为空字符串（`""`），因此 `elt.color = null` 相当于 `elt.color = ""`。
+
+## 示例
+
+```js
+// 假设在 HTML 中存在 <font id="f"> 元素
+const f = document.getElementById("f");
+f.color = "green";
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- 它属于 {{domxref("HTMLFontElement")}} 接口。
diff --git a/files/zh-cn/web/api/htmlfontelement/face/index.md b/files/zh-cn/web/api/htmlfontelement/face/index.md
new file mode 100644
index 00000000000000..ca981c2aa0cbed
--- /dev/null
+++ b/files/zh-cn/web/api/htmlfontelement/face/index.md
@@ -0,0 +1,42 @@
+---
+title: HTMLFontElement：face 属性
+slug: Web/API/HTMLFontElement/face
+l10n:
+  sourceCommit: b25d8774aa7bcc6a053e26cf804ad454f51e134b
+---
+
+{{deprecated_header}}{{ APIRef("HTML DOM") }}
+
+已过时的 **`HTMLFontElement.face`** 属性是一个反映 [`face`](/zh-CN/docs/Web/HTML/Element/font#face) HTML 属性的字符串，包含一个或多个字体名称的逗号分隔列表。
+
+默认样式的文档文本将以客户端浏览器支持的首个字体进行渲染。如果本地系统未安装列出的任何字体，浏览器通常会默认使用该系统的比例字体或等宽字体。
+
+字符串的格式必须遵循以下 HTML 微语法之一：
+
+| 微语法                       | 描述                               | 示例              |
+| ---------------------------- | ---------------------------------- | ----------------- |
+| 一个或多个有效字体名称的列表 | _在本地系统必须存在的字体名称列表_ | `courier,verdana` |
+
+## 值
+
+一个字符串。
+
+## 示例
+
+```js
+// 假设在 HTML 中存在 <font id="f"> 元素
+const f = document.getElementById("f");
+f.face = "arial";
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- 它属于 {{domxref("HTMLFontElement")}} 接口。
diff --git a/files/zh-cn/web/api/htmlfontelement/index.md b/files/zh-cn/web/api/htmlfontelement/index.md
new file mode 100644
index 00000000000000..d34ed650fb2782
--- /dev/null
+++ b/files/zh-cn/web/api/htmlfontelement/index.md
@@ -0,0 +1,39 @@
+---
+title: HTMLFontElement
+slug: Web/API/HTMLFontElement
+l10n:
+  sourceCommit: 7e6e5f5d4c1c984af3d4ebf9399042d19eccea1e
+---
+
+{{APIRef("HTML DOM")}}{{Deprecated_Header}}
+
+实现字体元素的文档对象模型（DOM）表示。HTML 字体元素 {{HTMLElement("font")}} 定义文本的字体大小、字体和颜色。
+
+{{InheritanceDiagram}}
+
+## 实例属性
+
+_从其父接口 {{domxref("HTMLElement")}} 继承属性。_
+
+- {{domxref("HTMLFontElement.color")}} {{Deprecated_Inline}}
+  - : 一个反映 [`color`](/zh-CN/docs/Web/HTML/Element/font#color) HTML 属性的字符串，包含命名颜色或以十六进制 #RRGGBB 格式指定的颜色。
+- {{domxref("HTMLFontElement.face")}} {{Deprecated_Inline}}
+  - : 一个反映 [`face`](/zh-CN/docs/Web/HTML/Element/font#face) HTML 属性的字符串，包含一个或多个字体名称的逗号分隔列表。
+- {{domxref("HTMLFontElement.size")}} {{Deprecated_Inline}}
+  - : 一个反映 [`size`](/zh-CN/docs/Web/HTML/Element/font#size) HTML 属性的字符串，包含从 1 到 7 的字体大小或相对于默认值 3 的数字，例如 -2 或 +1。
+
+## 实例方法
+
+_没有特定的方法，从其父接口 {{domxref("HTMLElement")}} 继承方法。_
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- 实现此接口的 HTML 元素：{{HTMLElement("font")}}
diff --git a/files/zh-cn/web/api/htmlfontelement/size/index.md b/files/zh-cn/web/api/htmlfontelement/size/index.md
new file mode 100644
index 00000000000000..42e937eb4fc9e5
--- /dev/null
+++ b/files/zh-cn/web/api/htmlfontelement/size/index.md
@@ -0,0 +1,62 @@
+---
+title: HTMLFontElement：size 属性
+slug: Web/API/HTMLFontElement/size
+l10n:
+  sourceCommit: b25d8774aa7bcc6a053e26cf804ad454f51e134b
+---
+
+{{deprecated_header}}{{ APIRef("HTML DOM") }}
+
+已过时的 **`HTMLFontElement.size`** 属性是一个反映 [`size`](/zh-CN/docs/Web/HTML/Element/font#size) HTML 属性的字符串。包含从 1 到 7 的字体大小或相对于默认值 3 的数字，例如 -2 或 +1。
+
+字符串的格式必须遵循以下 HTML 微语法之一：
+
+<table class="no-markdown">
+  <thead>
+    <tr>
+      <th scope="col">微语法</th>
+      <th scope="col">描述</th>
+      <th scope="col">示例</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>有效的尺寸数字字符串</td>
+      <td><em>1 到 7 之间的整数</em></td>
+      <td><code>6</code></td>
+    </tr>
+    <tr>
+      <td>相对尺寸字符串</td>
+      <td>
+        <em>+x 或 -x，x 是相对于 3 的数字（结果应该是 1-7 之间）</em>
+      </td>
+      <td>
+        <code>+2<br />-1</code>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+## 值
+
+一个字符串。
+
+## 示例
+
+```js
+// 假设在 HTML 中存在 <font id="f"> 元素
+const f = document.getElementById("f");
+f.size = "6";
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- 它属于 {{domxref("HTMLFontElement")}} 接口。