zh-cn: update the translation of the UIEvent UIEvent.which and cr…

…eate `UIEvent.sourceCapabilities` (#25207) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: A1lo <[email protected]> Co-authored-by: Jason Ren <[email protected]>
mdn · Dec 27, 2024 · 8eebac6 · 8eebac6
1 parent f680575
commit 8eebac6
Show file tree

Hide file tree

Showing 3 changed files with 61 additions and 43 deletions.
diff --git a/files/zh-cn/web/api/uievent/index.md b/files/zh-cn/web/api/uievent/index.md
@@ -1,50 +1,44 @@
 ---
 title: UIEvent
 slug: Web/API/UIEvent
+l10n:
+  sourceCommit: 5b20f5f4265f988f80f513db0e4b35c7e0cd70dc
 ---
 
 {{APIRef("UI Events")}}
 
-`UIEvent` 接口表示简单的用户界面事件。
+**`UIEvent`** 接口表示简单的用户界面事件。
 
 `UIEvent` 是从 {{domxref("Event")}} 派生出来的。尽管 {{domxref("UIEvent.initUIEvent()")}} 方法为了向后兼容而一直保留着，但是你应该使用 {{domxref("UIEvent.UIEvent", "UIEvent()")}} 构造器来创建 `UIEvent` 对象。
 
-某些接口是这个的直接或间接后代：{{domxref("MouseEvent")}}, {{domxref("TouchEvent")}}, {{domxref("FocusEvent")}}, {{domxref("KeyboardEvent")}}, {{domxref("WheelEvent")}}, {{domxref("InputEvent")}}, 和{{domxref("CompositionEvent")}}.
+某些接口是此接口的直接或间接后代：{{domxref("MouseEvent")}}、{{domxref("TouchEvent")}}、{{domxref("FocusEvent")}}、{{domxref("KeyboardEvent")}}、{{domxref("WheelEvent")}}、{{domxref("InputEvent")}} 和 {{domxref("CompositionEvent")}}。
 
-## Constructors
+{{InheritanceDiagram}}
+
+## 构造函数
 
 - {{domxref("UIEvent.UIEvent()", "UIEvent()")}}
-  - : 创建一个 `UIEvent` 对象
-
-## 属性
-
-_也继承了父代 {{domxref("Event")}} 的一些属性。_
-
-- {{domxref("UIEvent.cancelBubble")}} {{Non-standard_inline}} {{Deprecated_inline}}
-  - : 返回一个 {{jsxref("Boolean")}}，表示该事件的冒泡是否被取消。
-- {{domxref("UIEvent.detail")}}{{readonlyinline}}
-  - : Returns a `long` with details about the event, depending on the event type.
-- {{domxref("UIEvent.layerX")}} {{Non-standard_inline}} {{readonlyinline}}
-  - : 返回事件相对于当前层的水平坐标。
-- {{domxref("UIEvent.layerY")}} {{Non-standard_inline}} {{readonlyinline}}
-  - : 返回事件相对于当前层的垂直坐标。
-- {{domxref("UIEvent.pageX")}} {{Non-standard_inline}} {{readonlyinline}}
-  - : 返回事件相对于整个文档的水平坐标。
-- {{domxref("UIEvent.pageY")}} {{Non-standard_inline}} {{readonlyinline}}
-  - : 返回事件相对于整个文档的垂直坐标。
-- {{domxref("UIEvent.sourceCapabilities")}} {{non-standard_inline}} {{readonlyinline}}
-  - : 返回输入设备功能接口的一个实例，它提供有关负责生成 touch 事件的物理设备的信息。
-- {{domxref("UIEvent.view")}}{{readonlyinline}}
-  - : 返回一个包含了产生该事件的视图的 {{domxref("WindowProxy")}} 。
-- {{domxref("UIEvent.which")}} {{Non-standard_inline}} {{readonlyinline}}
-  - : 返回一个对应（键盘）按下的数字类型的 `keyCode` ，或者一个字母数字键按下时的字符码 (`charCode`)。
-
-## 方法
-
-_也继承了父代 {{domxref("Event")}} 的一些方法。_
+  - : 创建一个 `UIEvent` 对象。
+
+## 实例属性
+
+_此接口也继承了父接口 {{domxref("Event")}} 的一些属性。_
+
+- {{domxref("UIEvent.detail")}}{{ReadOnlyInline}}
+  - : 返回一个 `long`，其中包含有关事件的详细信息，具体取决于事件类型。
+- {{domxref("UIEvent.sourceCapabilities")}} {{Experimental_Inline}} {{ReadOnlyInline}}
+  - : 返回 `InputDeviceCapabilities` 接口的实例，它提供有关负责生成 touch 事件的物理设备的信息。
+- {{domxref("UIEvent.view")}}{{ReadOnlyInline}}
+  - : 返回一个包含了产生该事件的视图的 {{glossary("WindowProxy")}} 。
+- {{domxref("UIEvent.which")}} {{Deprecated_Inline}} {{ReadOnlyInline}}
+  - : 返回一个对应（键盘）按下的数字类型的 `keyCode`，或者一个字母数字键按下时的字符码（`charCode`）。
+
+## 实例方法
+
+_也继承了父接口 {{domxref("Event")}} 的一些方法。_
 
 - {{domxref("UIEvent.initUIEvent()")}} {{deprecated_inline}}
-  - : 初始化一个 `UIEvent` 对象。如果事件已经被分派，这个方法什么都不做。
+  - : 初始化一个 `UIEvent` 对象。如果事件已经被派发，这个方法什么都不做。
 
 ## 规范
 
@@ -54,7 +48,7 @@ _也继承了父代 {{domxref("Event")}} 的一些方法。_
 
 {{Compat}}
 
-## 相关链接
+## 参见
 
-- [Introduction to events](/zh-CN/docs/Learn_web_development/Core/Scripting/Events)
+- [事件介绍](/zh-CN/docs/Learn_web_development/Core/Scripting/Events)
 - {{domxref("Event")}}
diff --git a/files/zh-cn/web/api/uievent/sourcecapabilities/index.md b/files/zh-cn/web/api/uievent/sourcecapabilities/index.md
@@ -0,0 +1,26 @@
+---
+title: UIEvent：sourceCapabilities 属性
+slug: Web/API/UIEvent/sourceCapabilities
+l10n:
+  sourceCommit: 8cac4a3fed6a702840efd2deda67a922120732d0
+---
+
+{{APIRef("Input Device Capabilities API")}}{{SeeCompatTable}}
+
+{{domxref("UIEvent")}} 接口的 **`sourceCapabilities `** 只读属性返回 {{domxref('InputDeviceCapabilities')}} 接口的一个实例，该实例提供有关负责生成触摸事件的物理设备的信息。如果没有输入设备对事件负责，则返回 `null`。
+
+当单个用户与输入设备的交互生成一系列不同的输入事件时，所有这些事件的 `sourceCapabilities` 属性将指向 `InputDeviceCapabilities` 的同一个实例。例如，当用户将手指从触摸屏上抬起时，可能会生成若干个 UIEvent，包括 `touchend`、`mousedown`、`click` 和 `focus`。所有这些事件必须具有表示触摸屏的相同 `sourceCapabilities`。
+
+只有当该交互是 Web 平台提供的抽象的一部分时，设备才被视为对事件“负责”。例如，许多用户代理允许使用鼠标或键盘调整窗口大小，但这个细节不会以任何方式暴露给 Web 平台，因此 resize 事件的 sourceCapabilities 通常为 null。
+
+## 值
+
+{{domxref('InputDeviceCapabilities')}} 的实例。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
diff --git a/files/zh-cn/web/api/uievent/view/index.md b/files/zh-cn/web/api/uievent/view/index.md
@@ -1,24 +1,22 @@
 ---
-title: 用户界面项目视图
+title: UIEvent：view 属性
 slug: Web/API/UIEvent/view
+l10n:
+  sourceCommit: 0c8a320b035cf625c1df67713a94ead2e7f3aec6
 ---
 
 {{APIRef("UI Events")}}
 
-The **`UIEvent.view`** 只读属性返回的生成事件的 {{domxref("document.defaultView")}} (`window` of the document) 对象。在浏览器中，这是事件所在的 {{ domxref("Window") }} 对象。
+**`UIEvent.view`** 只读属性返回 {{glossary("WindowProxy")}} 生成事件的对象。在浏览器中，这个事件发生在 {{domxref("Window")}} 对象。
 
-## 语法
-
-```plain
-var view = event.view;
-```
+## 值
 
 - `view` 是对 `AbstractView` 对象的引用。
 
-## 技术参数
+## 规范
 
 {{Specifications}}
 
-## 浏览器的兼容性
+## 浏览器兼容性
 
 {{Compat}}