KeyboardEvent: initKeyEvent() 方法

警告： 请勿使用此方法；请改用 KeyboardEvent() 构造函数！

此方法已从 DOM 规范中删除，并且不受任何当前浏览器支持。Firefox 从 93 版开始在首选项 (dom.keyboardevent.init_key_event.enabled) 后隐藏此方法，并计划在不久后将其删除。

已弃用： 此功能不再推荐。尽管某些浏览器可能仍然支持它，但它可能已从相关的 Web 标准中删除，可能正在被弃用，或者可能仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅此页面底部的兼容性表以指导您的决策。请注意，此功能可能随时停止工作。

KeyboardEvent.initKeyEvent() 方法用于初始化使用 document.createEvent ("KeyboardEvent") 创建的事件的值。以这种方式初始化的事件必须使用 document.createEvent ("KeyboardEvent") 方法创建。必须调用 initKeyEvent() 来设置事件，然后才能将其分派。

语法

initKeyEvent (type, bubbles, cancelable, view,
                    ctrlKey, altKey, shiftKey, metaKey,
                    keyCode, charCode)

参数

type: 表示事件类型的字符串。
bubbles: 一个布尔值，指示事件是否应该冒泡到事件链中（请参阅 bubbles）。
cancelable: 一个布尔值，指示事件是否可以取消（请参阅 cancelable）。
view: 指定 UIEvent.view；此值可以为 null。
ctrlKey: 一个布尔值，如果要生成的虚拟键是包含 Ctrl 键的键组合，则为 true。
altKey: 一个布尔值，如果要生成的虚拟键是包含 Alt 键的键组合，则为 true。
shiftKey: 一个布尔值，如果要生成的虚拟键是包含 Shift 键的键组合，则为 true。
metaKey: 一个布尔值，如果要生成的虚拟键是包含 Meta 键的键组合，则为 true。
keyCode: 一个 unsigned long，表示按下的键的虚拟键代码值，否则为 0。有关键代码列表，请参阅 KeyboardEvent.keyCode。
charCode: 一个 unsigned long，表示与按下的键关联的 Unicode 字符，否则为 0。

返回值

无 (undefined）。

示例

const event = document.createEvent("KeyboardEvent"); // create a key event
// define the event
event.initKeyEvent(
  "keypress", // typeArg,
  true, // canBubbleArg,
  true, // cancelableArg,
  null, // viewArg, Specifies UIEvent.view. This value may be null.
  false, // ctrlKeyArg,
  false, // altKeyArg,
  false, // shiftKeyArg,
  false, // metaKeyArg,
  9, // keyCodeArg,
  0,
); // charCodeArg);

document.getElementById("blah").dispatchEvent(event);

规范

键盘事件的此实现基于 DOM 2 事件的早期版本中的键事件规范，后来从该规范中删除，转而支持 KeyboardEvent()，应该改用它。