KeyboardEvent: initKeyboardEvent() メソッド

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

KeyboardEvent.initKeyboardEvent() メソッドは、キーボードイベントオブジェクトの属性を初期化します。このメソッドは DOM Level 3 Events の草案で導入されましたが、より新しい草案では非推奨とされています。Gecko はこの機能に対応していません。このメソッドを実験的に実装すると、既存のウェブアプリが壊れてしまうからです(Firefox バグ 999645 を参照してください)。 ウェブアプリケーションは、もしコンストラクターが使用できるのであれば、代わりに使用する必要があります。

構文

js
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