此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

Document:createEvent() 方法

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

警告:許多與 createEvent 一起使用的方法,例如 initCustomEvent,已被淘汰。請改用事件建構子

建立指定類型的事件。回傳的物件應先初始化,然後可以傳遞給 EventTarget.dispatchEvent

語法

js
createEvent(type)

參數

type

一個字串,表示要建立的事件類型。可能的事件類型包括 "UIEvents""MouseEvents""MutationEvents""HTMLEvents"。詳情請參見備註部分。

回傳值

一個 Event 物件。

範例

js
// 建立事件。
const event = document.createEvent("Event");

// 定義事件名稱為「build」。
event.initEvent("build", true, true);

// 監聽該事件。
elem.addEventListener(
  "build",
  (e) => {
    // e.target 與 elem 相符
  },
  false,
);

// 目標可以是任何 Element 或其他 EventTarget。
elem.dispatchEvent(event);

備註

適合傳遞給 createEvent() 的事件類型字串列於 DOM 標準——請參見步驟 2 的表格。請記住,大多數事件物件現在都有建構子,這是建立事件物件實例的現代推薦方式。

規範

Specification
DOM
# dom-document-createevent

瀏覽器相容性

參見