KeyboardEvent: initKeyboardEvent() 方法

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

KeyboardEvent.initKeyboardEvent() 方法用於初始化鍵盤事件物件的屬性。該方法在 DOM Level 3 Events 的草案中引入,但在較新的草案中已棄用。Gecko 將不再支援此功能,因為實現此方法作為實驗性功能會破壞現有的 Web 應用程式(請參閱 Firefox bug 999645)。如果可用,Web 應用程式應使用建構函式而不是此方法。

語法

js
initKeyboardEvent(type, canBubble, cancelable,
                  view, key, location, ctrlKey,
                  altKey, shiftKey, metaKey)

引數

type

鍵盤事件的型別;瀏覽器始終將其設定為 keydownkeypresskeyup 之一。

canBubble 可選

指示事件是否可以冒泡。預設為 false

cancelable 可選

指示事件是否可以取消。預設為 false

view 可選

與之關聯的 WindowProxy。預設為 null

key 可選

key 屬性的值。預設為 ""

location 可選

location 屬性的值。預設為 0

ctrlKey 可選

指示 control 鍵修飾符是否處於活動狀態。預設為 false

altKey 可選

指示 alt 鍵修飾符是否處於活動狀態。預設為 false

shiftKey 可選

指示 shift 鍵修飾符是否處於活動狀態。預設為 false

metaKey 可選

指示 meta 鍵修飾符是否處於活動狀態。預設為 false

返回值

無(undefined)。

規範

規範
UI 事件
# dom-keyboardevent-initkeyboardevent

KeyboardEvent 介面規範經歷了多個草案版本,最初在 DOM Events Level 2 中被放棄,因為未能達成共識,後來在 DOM Events Level 3 中重新審議。這導致了非標準初始化方法的實現,Gecko 瀏覽器實現了早期的 DOM Events Level 2 版本 KeyboardEvent.initKeyEvent(),其他瀏覽器實現了早期的 DOM Events Level 3 版本 KeyboardEvent.initKeyboardEvent()。現在兩者都被現代的建構函式用法所取代:KeyboardEvent()

瀏覽器相容性