Document:createEvent() 方法

警告:许多与 createEvent 一起使用的方法(例如 initCustomEvent)已弃用。请改用 事件构造函数

创建指定类型的 事件。返回的对象应首先初始化,然后才能传递给 EventTarget.dispatchEvent

语法

js
createEvent(type)

参数

类型

表示要创建的事件类型的字符串。可能的事件类型包括 "UIEvents""MouseEvents""MutationEvents""HTMLEvents"。有关详细信息,请参阅 注释 部分。

返回值

一个 Event 对象。

示例

js
// Create the event.
const event = document.createEvent("Event");

// Define that the event name is 'build'.
event.initEvent("build", true, true);

// Listen for the event.
elem.addEventListener(
  "build",
  (e) => {
    // e.target matches elem
  },
  false,
);

// Target can be any Element or other EventTarget.
elem.dispatchEvent(event);

注释

适合传递给 createEvent() 的事件类型字符串列在 DOM 标准 — 请参阅步骤 2 中的表格 中。请记住,大多数事件对象现在都有构造函数,这是创建事件对象实例的现代推荐方法。

规范

规范
DOM 标准
# dom-document-createevent

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅