KeyboardEvent.initKeyEvent()

这篇翻译不完整。请帮忙从英语翻译这篇文章

非标准
该特性是非标准的,请尽量不要在生产环境中使用它!

已废弃
该特性已经从 Web 标准中删除,虽然一些浏览器目前仍然支持它,但也许会在未来的某个时间停止支持,请尽量不要使用该特性。

The KeyboardEvent.initKeyEvent method is used to initialize the value of an event created using document.createEvent("KeyboardEvent"). Events initialized in this way must have been created with the document.createEvent("KeyboardEvent") method. initKeyEvent must be called to set the event before it is dispatched.

Do not use this method any more, use the KeyboardEvent() constructor instead.

This method is based on early drafts of Document Object Model (DOM) Level 2 Events Specification and is implemented in Gecko-based browsers; other browsers implemented KeyboardEvent.initKeyboardEvent based on early drafts of Document Object Model (DOM) Level 3 Events Specification. Favor the modern constructor structure as the only cross-browser way of building events.

Syntax

event.initKeyEvent (type, bubbles, cancelable, viewArg, 
                    ctrlKeyArg, altKeyArg, shiftKeyArg, metaKeyArg, 
                    keyCodeArg, charCodeArg) 

Parameters

type
Is a DOMString representing the type of event.
bubbles
Is a Boolean indicating whether the event should bubble up through the event chain or not (see bubbles).
cancelable
Is a Boolean i indicating whether the event can be canceled (see cancelable).
viewArg
Specifies the UIEvent.view; this value may be null.
ctrlKeyArg
Is a Boolean that is true if the virtual key to be generated is a combination of keys containing the Ctrl key.
altKeyArg
Is a Boolean that is true if the virtual key to be generated is a combination of keys containing the Alt key.
shiftKeyArg
A Boolean that is true if the virtual key to be generated is a combination of keys containing the Shift key.
metaKeyArg
Is a Boolean that is true if the virtual key to be generated is a combination of keys containing the Meta key.
keyCodeArg
Is a unsigned long representing the virtual key code value of the key which was depressed, otherwise 0. See KeyboardEvent.keyCode for the list of key codes.
charCodeArg
Is a unsigned long representingthe Unicode character associated with the depressed key otherwise 0.

Example

var 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);

Specification

This implementation of keyboard events is based on the key events spec in the early versions of DOM 2 Events, later removed from that spec.

The initKeyEvent is the current Gecko equivalent of the DOM Level 3 Events (initially drafted and also deprecated in favor of KeyboardEvent() Keyboard.initKeyboardEvent() method with the following arguments :

typeArg of type DOMString               
canBubbleArg of type boolean            
cancelableArg of type boolean           
viewArg of type views::AbstractView     
keyIdentifierArg of type DOMString      
keyLocationArg of type unsigned long    
modifiersList of type DOMString);

文档标签和贡献者

 此页面的贡献者: Wonder233
 最后编辑者: Wonder233,