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

zh-cn: update the translation of the UIEvent UIEvent.which and create UIEvent.sourceCapabilities #25207

Merged
merged 18 commits into from
Dec 27, 2024
Merged
Show file tree
Hide file tree
Changes from 13 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
54 changes: 24 additions & 30 deletions files/zh-cn/web/api/uievent/index.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,44 @@
---
title: UIEvent
slug: Web/API/UIEvent
l10n:
sourceCommit: 5b20f5f4265f988f80f513db0e4b35c7e0cd70dc
---

{{APIRef("UI Events")}}
kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved

`UIEvent` 接口表示简单的用户界面事件。
**`UIEvent`** 接口表示简单的用户界面事件。

`UIEvent` 是从 {{domxref("Event")}} 派生出来的。尽管 {{domxref("UIEvent.initUIEvent()")}} 方法为了向后兼容而一直保留着,但是你应该使用 {{domxref("UIEvent.UIEvent", "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")}}
kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved

## Constructors
{{InheritanceDiagram}}

## 构造函数

- {{domxref("UIEvent.UIEvent()", "UIEvent()")}}
- : 创建一个 `UIEvent` 对象
jasonren0403 marked this conversation as resolved.
Show resolved Hide resolved

## 属性

_也继承了父代 {{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`)。
## 实例属性

kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved
_此接口也继承了父接口 {{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`)。
kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved

kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved
## 方法
kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved

_也继承了父代 {{domxref("Event")}} 的一些方法。_
_也继承了父接口 {{domxref("Event")}} 的一些方法。_

- {{domxref("UIEvent.initUIEvent()")}} {{deprecated_inline}}
- : 初始化一个 `UIEvent` 对象。如果事件已经被分派,这个方法什么都不做。
- : 初始化一个 `UIEvent` 对象。如果事件已经被派发,这个方法什么都不做。

## 规范

Expand All @@ -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")}}
26 changes: 26 additions & 0 deletions files/zh-cn/web/api/uievent/sourcecapabilities/index.md
Original file line number Diff line number Diff line change
@@ -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}}
10 changes: 6 additions & 4 deletions files/zh-cn/web/api/uievent/view/index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
---
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")}} 对象。

## 语法
kongbai1996 marked this conversation as resolved.
Show resolved Hide resolved

Expand All @@ -15,10 +17,10 @@ var view = event.view;

- `view` 是对 `AbstractView` 对象的引用。

## 技术参数
## 规范

{{Specifications}}

## 浏览器的兼容性
## 浏览器兼容性

{{Compat}}
Loading