事件:initEvent() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

注意:此功能在 Web Workers 中可用。

Event.initEvent() 方法用於初始化使用 Document.createEvent() 建立的 event 的值。

以這種方式初始化的事件必須是使用 Document.createEvent() 方法建立的。在透過 EventTarget.dispatchEvent() 分派事件之前,必須呼叫此方法來設定事件。一旦分派,它將不再起任何作用。

注意: 請勿再使用此方法,因為它已棄用。 請改用特定的事件建構函式,例如 Event()。有關如何使用這些建構函式的更多資訊,請參閱 建立和分派事件 部分。

語法

js
initEvent(type, bubbles, cancelable)

引數

type

定義事件型別的字串。

bubbles

一個布林值,決定事件是否應該冒泡透過事件鏈。設定後,只讀屬性 Event.bubbles 將給出其值。

cancelable

一個布林值,定義事件是否可以被取消。設定後,只讀屬性 Event.cancelable 將給出其值。

返回值

無。

示例

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

// Create a click event that bubbles up and
// cannot be canceled
event.initEvent("click", true, false);

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

elem.dispatchEvent(event);

規範

規範
DOM
# dom-event-initevent

瀏覽器相容性

另見

  • 替代此已棄用方法的建構函式:Event()。要建立比 Event 更具體的事件介面,請使用為所需事件介面定義的建構函式。