KeyboardEvent: initKeyboardEvent() メソッド
非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。
KeyboardEvent.initKeyboardEvent()
メソッドは、キーボードイベントオブジェクトの属性を初期化します。このメソッドは DOM Level 3 Events の草案で導入されましたが、より新しい草案では非推奨とされています。Gecko はこの機能に対応していません。このメソッドを実験的に実装すると、既存のウェブアプリが壊れてしまうからです(Firefox バグ 999645 を参照してください)。
ウェブアプリケーションは、もしコンストラクターが使用できるのであれば、代わりに使用する必要があります。
構文
initKeyboardEvent(type, canBubble, cancelable,
view, key, location, ctrlKey,
altKey, shiftKey, metaKey)
引数
type
-
キーボードイベントの型。ブラウザーは常に
keydown
,keypress
,keyup
のいずれかを設定します。 canBubble
省略可-
イベントがバブリングするかどうかを示す。既定値は
false
です。 cancelable
省略可-
イベントをキャンセルできるかどうかを示します。既定値は
false
です。 view
省略可-
関連付けられている WindowProxy を指定します。既定値は
null
です。 key
省略可-
key 属性の値。既定値は
""
です。 location
省略可-
location 属性の値。既定値は
0
です。 ctrlKey
省略可-
コントロールキーの修飾が有効であるかどうかを示します。既定値は
false
です。 altKey
省略可-
Alt キーの修飾が有効かどうかを示します。既定値は
false
です。 shiftKey
省略可-
Shift キーの修飾が有効であるかどうかを示します。既定値は
false
です。 metaKey
省略可-
メタキーの修飾が有効であるかどうかを示します。既定値は
false
です。
返値
なし (undefined
)。
仕様書
Specification |
---|
UI Events # dom-keyboardevent-initkeyboardevent |
KeyboardEvent
インターフェイス仕様は多くの草稿を経ており、最初の DOM Events Level 2 では合意が得られなかったため削除され、次の DOM Events Level 3 で採用されました。このため、標準外の初期化メソッドが、初期の DOM Events Level 2 バージョンの KeyboardEvent.initKeyEvent()
が Gecko ブラウザーに、初期の DOM Events Level 3 バージョンの KeyboardEvent.initKeyboardEvent()
がその他のブラウザーに実装されました。両方とも、コンストラクター KeyboardEvent()
の現代的な用法に置き換えられました。
ブラウザーの互換性
BCD tables only load in the browser