chore(zh-cn): translate for InputEvent.inputType (#18983)

* chore(zh-cn): translate for InputEvent.inputType * chore(zh-cn): translate InputEvent.data * chore(zh-cn): translate for InputEvent.dataTransfer * chore(zh-cn): translate for InputEvent() * Update files/zh-cn/web/api/inputevent/inputevent/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/zh-cn/web/api/inputevent/data/index.md Co-authored-by: Jason Lam <[email protected]> * Update files/zh-cn/web/api/inputevent/data/index.md Co-authored-by: Jason Lam <[email protected]> * Update files/zh-cn/web/api/inputevent/data/index.md Co-authored-by: Jason Lam <[email protected]> * Update files/zh-cn/web/api/inputevent/datatransfer/index.md Co-authored-by: Jason Lam <[email protected]> * Update files/zh-cn/web/api/inputevent/inputevent/index.md Co-authored-by: Jason Lam <[email protected]> * translate the content in HTML code * Update files/zh-cn/web/api/inputevent/datatransfer/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/zh-cn/web/api/inputevent/datatransfer/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Jason Lam <[email protected]>
mdn · Mar 29, 2024 · fc07a44 · fc07a44
1 parent 544d583
commit fc07a44
Show file tree

Hide file tree

Showing 4 changed files with 59 additions and 72 deletions.
diff --git a/files/zh-cn/web/api/inputevent/data/index.md b/files/zh-cn/web/api/inputevent/data/index.md
@@ -1,27 +1,21 @@
 ---
-title: InputEvent.data
+title: InputEvent：data 属性
 slug: Web/API/InputEvent/data
+l10n:
+  sourceCommit: 72ca3d725e3e56b613de3ac9727bd0d6d619c38a
 ---
 
-{{SeeCompatTable}}{{APIRef("DOM Events")}}
+{{APIRef("UI Events")}}
 
-> **备注：** 请注意，**`data`** 属性在使用键盘输入时会返回输入的字符内容，但在粘贴、拖动时可能会返回 `null`，这取决于浏览器。浏览器也可能把一些数据保存在 {{domxref("InputEvent.dataTransfer")}}，而不是该 **`data`** 属性中。
+{{domxref("InputEvent")}} 接口中的只读属性 **`data`** 返回插入字符的字符串。如果更改未插入文本（例如删除字符时），则其可能为空字符串。
 
-{{domxref("InputEvent")}} 接口中的只读属性 **`data`** 返回含有插入字符数据的 {{domxref("DOMString")}}。如果更改未插入文本（例如删除字符时），则其可能为空字符串。
+## 值
 
-## 语法
-
-```
-var string = inputEvent.data;
-```
-
-### 返回值
-
-一个 {{domxref("DOMString")}}。
+一个字符串。
 
 ## 示例
 
-在下面的简单示例中，我们在 [input](/zh-CN/docs/Web/API/Element/input_event) 事件上设置了一个事件监听器，以便在对 {{htmlelement("input")}} 元素的内容进行任何更改时（通过键入或粘贴），通过 **`InputEvent.data`** 属性检索添加的文本，并在 `<input>` 下面的段落中报告。
+在下面的简单示例中，我们在 [input](/zh-CN/docs/Web/API/Element/input_event) 事件上设置了一个事件监听器，任何对 {{htmlelement("input")}} 元素的文本更改都会被 `InputEvent.data` 获取，使用 [`Node.textContent`](/zh-CN/docs/Web/API/Node/textContent) 属性将其插入到段落中。
 
 ```html
 <p>Some text to copy and paste.</p>
@@ -32,11 +26,11 @@ var string = inputEvent.data;
 ```
 
 ```js
-var editable = document.querySelector("input");
-var result = document.querySelector(".result");
+const editable = document.querySelector("input");
+const result = document.querySelector(".result");
 
 editable.addEventListener("input", (e) => {
-  result.textContent = "Inputted text: " + e.data;
+  result.textContent = `输入的文字：${e.data}`;
 });
 ```
 

diff --git a/files/zh-cn/web/api/inputevent/datatransfer/index.md b/files/zh-cn/web/api/inputevent/datatransfer/index.md
@@ -1,51 +1,43 @@
 ---
-title: InputEvent.dataTransfer
+title: InputEvent：dataTransfer 属性
 slug: Web/API/InputEvent/dataTransfer
+l10n:
+  sourceCommit: 72ca3d725e3e56b613de3ac9727bd0d6d619c38a
 ---
 
-{{SeeCompatTable}}{{APIRef("DOM Events")}}
+{{APIRef("UI Events")}}
 
 {{domxref("InputEvent")}} 接口中的只读属性 **`dataTransfer`** 返回一个 {{domxref("DataTransfer")}} 对象，该对象包含有关要添加到可编辑内容，或从可编辑内容中删除的富文本或纯文本数据的信息。
 
-## 语法
-
-```plain
-var dataTransfer = inputEvent.dataTransfer
-```
-
-### 返回值
+## 值
 
 一个 {{domxref("DataTransfer")}} 对象。
 
 ## 示例
 
-在下面的简单示例中，我们在 [input](/zh-CN/docs/Web/API/Element/input_event) 事件上设置了一个事件监听器，以便在将任何内容粘贴到 {{htmlelement("p")}} 元素时，通过 [`InputEvent.dataTransfer.getData()`](/zh-CN/docs/Web/API/DataTransfer/getData) 方法检索其 HTML 源代码，并在输入框下面的段落中报告。
+在下面的简单示例中，我们在 [input](/zh-CN/docs/Web/API/Element/input_event) 事件上设置了一个事件监听器，以便在将任何内容粘贴到可编辑的 {{htmlelement("p")}} 元素时，通过 [`InputEvent.dataTransfer.getData()`](/zh-CN/docs/Web/API/DataTransfer/getData) 方法获取其 HTML 源代码，并将其报告在输入框下面的段落中。
 
-尝试复制并粘贴提供的部分内容以查看效果。注意，部分浏览器对其支持不佳。
+尝试复制并粘贴提供的部分内容以查看效果。
 
 ```html
-<p><span style="font-weight: bold; color: blue">Whoa, bold blue text!</span></p>
+<p><span style="font-weight: bold; color: blue">哇，粗体的蓝色文本！</span></p>
 <p>
-  <span style="font-weight: italic; color: red"
-    >Exciting: italic red text!</span
-  >
+  <span style="font-weight: italic; color: red">令人兴奋的斜体红色文本！</span>
 </p>
-<p>Boring normal text ;-(</p>
+<p>令人厌倦的普通文本</p>
 
 <hr />
 
 <p contenteditable="true">
-  Go on, try pasting some content into this editable paragraph and see what
-  happens!
+  继续，尝试将一些内容粘贴到这个可编辑的段落中，看看会发生什么！
 </p>
 
 <p class="result"></p>
 ```
 
 ```js
-var editable = document.querySelector("p[contenteditable]");
-var result = document.querySelector(".result");
-var dataTransferObj;
+const editable = document.querySelector("p[contenteditable]");
+const result = document.querySelector(".result");
 
 editable.addEventListener("input", (e) => {
   result.textContent = e.dataTransfer.getData("text/html");

diff --git a/files/zh-cn/web/api/inputevent/inputevent/index.md b/files/zh-cn/web/api/inputevent/inputevent/index.md
@@ -1,38 +1,46 @@
 ---
-title: InputEvent()
+title: InputEvent：InputEvent() 构造函数
 slug: Web/API/InputEvent/InputEvent
+l10n:
+  sourceCommit: eab4066e72d5478de920e4020e5db71214dcffa6
 ---
 
-{{APIRef("DOM Events")}}{{SeeCompatTable}}
+{{APIRef("UI Events")}}
 
-构造函数 **`InputEvent()`** 返回一个新创建的 {{domxref("InputEvent")}} 对象。
+**`InputEvent()`** 构造函数创建一个新的 {{domxref("InputEvent")}} 对象。
 
 ## 语法
 
-```
- event = new InputEvent(typeArg, inputEventInit);
+```js-nolint
+new InputEvent(type)
+new InputEvent(type, options)
 ```
 
 ### 参数
 
-- _typeArg_
-  - : 一个 {{domxref("DOMString")}} ，表示事件的名称。
-- _inputEventInit_{{optional_inline}}
+- `type`
+  - : 表示事件名称的字符串。区分大小写，浏览器将其设置为 `beforeinput` 或者 `input`。
+- `options` {{optional_inline}}
+  - : 一个对象，_除了 {{domxref("UIEvent/UIEvent", "UIEvent()")}} 中定义的属性之外_，还具有以下属性：
+    - `inputType` {{optional_inline}}
+      - : 指定可编辑内容更改类型的字符串，例如插入、删除或格式化文本。
+    - `data` {{optional_inline}}
+      - : 包含要插入的字符的字符串。如果更改未插入文本（例如删除字符时），则其可能为空字符串。
+    - `isComposing` {{optional_inline}}
+      - : 一个布尔值，指示事件是组合会话的一部分，这意味着它在 {{domxref("Element/compositionstart_event", "compositionstart")}} 事件之后，但在 {{domxref("Element/compositionend_event", "compositionend")}} 事件之前。默认值为 `false`。
+
+## 返回值
 
-  - : 一个 `InputEventInit` 字典，有以下字段：
+一个 {{domxref("InputEvent")}} 对象。
 
-    - `inputType`（可选），指定可编辑内容更改类型的字符串，例如插入、删除或格式化文本。
-    - `data`（可选），包含要插入的字符的字符串。如果更改未插入文本（例如删除字符时），则其可能为空字符串。
-    - `dataTransfer`（可选），一个 {{domxref("DataTransfer")}} 对象，其中包含有关添加到可编辑内容，或从可编辑内容中删除的富文本或纯文本数据的信息。
-    - `isComposing`（可选），一个布尔值，指示事件是组合会话的一部分，这意味着它在 [`compositionstart`](/zh-CN/docs/Web/API/Element/compositionstart_event) 事件之后，但在 [`compositionend`](/zh-CN/docs/Web/API/Element/compositionend_event) 事件之前。默认值为 `false`。
-    - `ranges`（可选），一个静态 {{domxref("Range")}} 数组，如果输入事件没有被取消，它将受到对 DOM 的更改的影响。
+## 规范
 
-`InputEventInit` 字典也接受来自 {{domxref("UIEvent.UIEvent", "UIEventInit")}} 以及 {{domxref("Event.Event", "EventInit")}} 字典的值。
+{{Specifications}}
 
 ## 浏览器兼容性
 
 {{Compat}}
 
-## 参考
+## 参见
 
 - {{domxref("InputEvent")}}，它构造的对象所属的接口。
diff --git a/files/zh-cn/web/api/inputevent/inputtype/index.md b/files/zh-cn/web/api/inputevent/inputtype/index.md
@@ -1,21 +1,17 @@
 ---
-title: InputEvent.inputType
+title: InputEvent：inputType 属性
 slug: Web/API/InputEvent/inputType
+l10n:
+  sourceCommit: 72ca3d725e3e56b613de3ac9727bd0d6d619c38a
 ---
 
-{{APIRef("DOM Events")}}
+{{APIRef("UI Events")}}
 
 {{domxref("InputEvent")}} 接口中的只读属性 **`inputType`** 返回对可编辑内容所做更改的类型。可能的更改包括插入、删除和格式化文本。
 
-## 语法
+## 值
 
-```js
-var aString = inputEvent.inputType;
-```
-
-### 返回值
-
-一个包含所做输入的类型的字符串。有许多可能的值，例如 `insertText`、`deleteContentBackward`、`insertFromPaste` 和 `formatBold`。有关可用输入类型的完整列表，请参阅 [Input Events Level 1 规范的属性部分](https://rawgit.com/w3c/input-events/v1/index.html#interface-InputEvent-Attributes)。
+一个包含所做输入的类型的字符串。有许多可能的值，例如 `insertText`、`deleteContentBackward`、`insertFromPaste` 和 `formatBold`。有关可用输入类型的完整列表，请参阅 [Input Events Level 2 规范的属性部分](https://w3c.github.io/input-events/#interface-InputEvent-Attributes)。
 
 ## 示例
 
@@ -28,17 +24,14 @@ var aString = inputEvent.inputType;
 <div
   contenteditable="true"
   style="margin: 20px;padding: 20px;border:2px dashed red;">
-  <p>
-    Some sample text. Try inserting line breaks, or deleting text in different
-    ways, or pasting different content in.
-  </p>
+  <p>一些示例文本。尝试插入换行符，或以不同方式删除文本，或粘贴不同内容。</p>
   <hr />
   <ul>
-    <li>A sample</li>
-    <li>bulleted</li>
-    <li>list.</li>
+    <li>一个例子</li>
+    <li>项目符号</li>
+    <li>列表</li>
   </ul>
-  <p>Another paragraph.</p>
+  <p>另一个段落。</p>
 </div>
 ```