MouseEvent: initMouseEvent() 方法

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

MouseEvent.initMouseEvent() 方法在滑鼠事件建立後（通常使用 Document.createEvent() 方法建立）初始化事件的屬性值。

警告： 請不要再使用此方法，因為它已被棄用。

請改用特定的事件建構函式，例如 MouseEvent()。有關如何使用這些方法的更多資訊，請參閱建立和分派事件部分。

透過此方法初始化的事件必須是使用 Document.createEvent() 方法建立的。在分派事件（使用 EventTarget.dispatchEvent()）之前，必須呼叫此方法來設定事件。

語法

initMouseEvent(type, canBubble, cancelable, view,
                     detail, screenX, screenY, clientX, clientY,
                     ctrlKey, altKey, shiftKey, metaKey,
                     button, relatedTarget)

引數

type: 用於設定事件 type 的字串。滑鼠事件的可能型別包括：click、mousedown、mouseup、mouseover、mousemove、mouseout。
canBubble: 事件是否可以冒泡。設定 Event.bubbles 的值。
cancelable: 事件的預設操作是否可以被阻止。設定 Event.cancelable 的值。
view: 事件的 AbstractView。你應該在此處傳遞 window 物件。設定 UIEvent.view 的值。
detail: 事件的滑鼠點選次數。設定 UIEvent.detail 的值。
screenX: 事件的螢幕 x 座標。設定 MouseEvent.screenX 的值。
screenY: 事件的螢幕 y 座標。設定 MouseEvent.screenY 的值。
clientX: 事件的客戶端 x 座標。設定 MouseEvent.clientX 的值。
clientY: 事件的客戶端 y 座標。設定 MouseEvent.clientY 的值。
ctrlKey: 在事件期間 control 鍵是否被按下。設定 MouseEvent.ctrlKey 的值。
altKey: 在事件期間 alt 鍵是否被按下。設定 MouseEvent.altKey 的值。
shiftKey: 在事件期間 shift 鍵是否被按下。設定 MouseEvent.shiftKey 的值。
metaKey: 在事件期間 meta 鍵是否被按下。設定 MouseEvent.metaKey 的值。
button: 事件的滑鼠 button。
relatedTarget: 事件的相關的 EventTarget。僅用於某些事件型別（例如 mouseover 和 mouseout）。在其他情況下，傳遞 null。

返回值

無（undefined）。

示例

const event = document.createEvent("MouseEvents");
event.initMouseEvent(
  "click",
  true,
  true,
  window,
  0,
  0,
  0,
  80,
  20,
  false,
  false,
  false,
  false,
  0,
  null,
);
document.body.dispatchEvent(event);

規範

規範
UI 事件 # dom-mouseevent-initmouseevent

瀏覽器相容性

另見

MouseEvent() 建構函式，這是建立 MouseEvent 的現代標準方法。
Event.initEvent() 是一個功能相似的較簡單方法。它也已過時，不應再使用。

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年7月29日，由 MDN 貢獻者更新。

在 GitHub 上檢視此頁面 • 報告此內容的問題