diff --git a/files/zh-cn/web/api/uievent/uievent/index.md b/files/zh-cn/web/api/uievent/uievent/index.md index 88fb4462f4fce8..6e48dcac749295 100644 --- a/files/zh-cn/web/api/uievent/uievent/index.md +++ b/files/zh-cn/web/api/uievent/uievent/index.md @@ -1,33 +1,43 @@ --- -title: UIEvent() +title: UIEvent:UIEvent() 构造函数 slug: Web/API/UIEvent/UIEvent +l10n: + sourceCommit: 22080a7cc403f7f45c8e85065b182c9f0d4d383c --- {{APIRef("UI Events")}} -**`UIEvent()`** 作为构造函数,可用于构造一个新的 {{domxref("UIEvent")}} 对象。 +**`UIEvent()`** 构造函数创建一个新的 {{domxref("UIEvent")}} 对象。 + +> [!NOTE] +> 如果你使用该构造函数构造合成事件,那么出于安全原因,该事件不会被*信任*。只有浏览器生成的 `UIEvent` 对象是受信任的,只有受信任的事件才会触发默认操作。 ## 语法 -``` -event = new UIEvent(typeArg [, UIEventInit]) +```js-nolint +new UIEvent(type) +new UIEvent(type, options) ``` -### Values +### 参数 -- `typeArg` - - : 传递的是一个 {{domxref("DOMString")}}类型的字符串,用来命名且重新发布的事件。 -- `UIEventInit` {{optional_inline}} +- `type` + - : 表示事件名称的字符串。大小写敏感,浏览器会将其设置为 `load`、`unload`、`abort`、`error` 或 `select`。 +- `options` {{optional_inline}} - - : 是 `UIEventInit` 集合,它拥有以下属性: + - : 一个对象,_除了 {{domxref("Event/Event", "Event()")}} 中定义的属性外_,还可以具有以下属性: + - `detail` {{optional_inline}} + - : 一个表示与事件关联的事件相关值的数字。默认值为 `0`,{{domxref("UIEvent.detail")}} 列出了标准事件的语义。 + - `view` {{optional_inline}} + - : 与事件关联的 {{domxref("Window")}}。默认值为 `null`。 + - `sourceCapabilities` {{optional_inline}} {{non-standard_inline}} + - : 提供有关负责生成触摸事件的物理设备的信息的 {{domxref("InputDeviceCapabilities")}} 对象。 - - **`detail`**: 可选,默认为 long 类型的 0 数值,用来标记事件的关联值。{{domxref("UIEvent.detail")}} 列出了标准事件的语义。 - - **`view`**: 可选,默认为 null,类型为 {{domxref("WindowProxy")}}, 用来关联{{domxref("Window")}} 与 event 本身。 - - **`sourceCapabilities`**: {{non-standard_inline}} 一个 {{domxref("InputDeviceCapabilities")}} 类型的接口实例 (对象),用来提供物理设备的触摸信息。 +### 返回值 - > **备注:** `UIEventInit` 合集依然接受从{{domxref("Event.Event", "EventInit")}} 定义来的合集。 +一个新的 {{domxref("UIEvent")}} 对象。 -## Specifications +## 规范 {{Specifications}} @@ -35,6 +45,6 @@ event = new UIEvent(typeArg [, UIEventInit]) {{Compat}} -## See also +## 参见 -- {{domxref("UIEvent")}}, the interface of the objects it constructs. +- 其构造的对象的接口:{{domxref("UIEvent")}}。