UIEvent:initUIEvent() 方法

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

UIEvent.initUIEvent() 方法在 UI 事件建立後對其進行初始化。

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

警告:請勿再使用此方法,因為它已被棄用。

請改用特定的事件建構函式,例如 UIEvent()。有關如何使用這些建構函式的更多資訊,請參閱 建立和派發事件 頁面。

語法

js
initUIEvent(type, canBubble, cancelable, view, detail)

引數

type

定義事件型別的字串。

canBubble

一個布林值,用於決定事件是否應在事件鏈中冒泡。設定後,只讀屬性 Event.bubbles 將提供其值。

cancelable

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

view

與事件關聯的 WindowProxy

detail

一個 unsigned long,指定有關事件的一些詳細資訊,具體取決於事件的型別。對於滑鼠事件,它指示在給定螢幕位置上滑鼠單擊了多少次。

返回值

無(undefined)。

示例

js
const e = document.createEvent("UIEvent");
// creates a click event that bubbles, can be cancelled,
// and with its view and detail property initialized to window and 1,
// respectively
e.initUIEvent("click", true, true, window, 1);

規範

規範
UI 事件
# dom-uievent-inituievent

瀏覽器相容性

另見

  • UIEvent
  • 替代此已棄用方法的建構函式:UIEvent()。也可以使用更具體的建構函式。