KeyboardEvent: метод initKeyEvent()

Предупреждение: НЕ используйте этот метод; используйте конструктор KeyboardEvent() вместо него!

Метод был удален из спецификации DOM и не поддерживается ни одним современным браузером. Firefox скрывает этот метод за настройкой (dom.keyboardevent.init_key_event.enabled) начиная с версии 93 и планирует удалить его вскоре после этого.

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут по-прежнему поддерживать её, она может быть уже удалена из соответствующих веб-стандартов, может быть в процессе удаления или может сохраняться только для обеспечения совместимости. Избегайте её использования и, если это возможно, обновите существующий код; см. таблицу совместимости в нижней части этой страницы для принятия решения. Имейте в виду, что эта функция может перестать работать в любое время.

Метод 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: Булево значение, которое true если виртуальный код клавиши, который будет сгенерирован, представляет собой комбинацию клавиш, содержащих клавишу Ctrl.
altKey: Булево значение, которое true если виртуальный код клавиши, который будет сгенерирован, представляет собой комбинацию клавиш, содержащих клавишу Alt.
shiftKey: Булево значение, которое true если виртуальный код клавиши, который будет сгенерирован, представляет собой комбинацию клавиш, содержащих клавишу Shift.
metaKey: Булево значение, которое true если виртуальный код клавиши, который будет сгенерирован, представляет собой комбинацию клавиш, содержащих клавишу Meta.
keyCode: Числовое значение, представляющее виртуальный код клавиши нажатой клавиши, в противном случае 0. См. KeyboardEvent.keyCode для списка кодов клавиш.
charCode: Числовое значение, представляющее символ Unicode, связанный с нажатой клавишей, в противном случае 0.

Возвращаемое значение

None (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 Events, позже удалённой из этой спецификации в пользу KeyboardEvent(), которую следует использовать вместо неё.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/initKeyEvent