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()

浏览器兼容性