UIEvent インターフェイスは、シンプルなユーザーインターフェイスのイベントを表します。
UIEvent は Event から派生しています。後方互換性のために UIEvent.initUIEvent() メソッドは維持されていますが、UIEvent オブジェクトは UIEvent() コンストラクターを使用して作成するべきです。
MouseEvent、TouchEvent、FocusEvent、KeyboardEvent、WheelEvent、InputEvent、CompositionEvent といったインターフェイスが、このインターフェイスの直接または間接の子孫です。
コンストラクター
UIEvent()UIEventオブジェクトを作成します。
プロパティ
このインターフェイスは、親である Event からプロパティを継承します。
UIEvent.cancelBubble- イベントのバブリングをキャンセルできるかを示す
Boolean。
UIEvent.detail読取専用- イベントのタイプに応じて、イベントの詳細を
longで返します。 UIEvent.isChar読取専用- イベントがキーキャラクターを生成したかを示す
Booleanを返します。 UIEvent.layerX読取専用- 現在のレイヤーにおける、イベントの水平座標を返します。
UIEvent.layerY読取専用- 現在のレイヤーにおける、イベントの垂直座標を返します。
UIEvent.pageX読取専用- ドキュメント全体における、イベントの水平座標を返します。
UIEvent.pageY読取専用- ドキュメント全体における、イベントの垂直座標を返します。
UIEvent.sourceCapabilities読取専用- タッチイベントの生成元である物理デバイスに関する情報を提供する、InputDeviceCapabilities インターフェイスのインスタンスを返します。
UIEvent.view読取専用- イベントを生成したビューを含む
WindowProxyを返します。 UIEvent.which読取専用- 押下されたキーの
keyCodeの数値、または押下された英数字キーのキャラクターコード (charCode) を返します。
メソッド
このインターフェイスは、親である Event からメソッドを継承します。
UIEvent.initUIEvent()UIEventオブジェクトを初期化します。イベントがすでにディスパッチされている場合は、何も行いません。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| InputDeviceCapabilities | 勧告改訂案 | sourceCapabilities プロパティを追加。 |
| Document Object Model (DOM) Level 3 Events Specification UIEvent の定義 |
草案 | UIEvent() コンストラクターを追加。initUIEvent() メソッドを非推奨化。view の型を AbstractView から WindowProxy に変更。 |
| Document Object Model (DOM) Level 2 Events Specification UIEvent の定義 |
勧告 | 最初の定義 |
ブラウザー実装状況
| 機能 | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有)[2] | ? | (有) | ? |
UIEvent() |
(有) | (有) | 11 (11) | ? | (有) | ? |
cancelBubble を Event で定義 |
? | (有) | 53 (53)[1] | ? | ? | ? |
| 機能 | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有)[2] | ? | (有) | ? |
UIEvent() |
(有) | (有) | 11.0 (11) | ? | (有) | ? |
cancelBubble を Event で定義 |
? | (有) | 53.0 (53)[1] | ? | ? | ? |
[1] Firefox 52 より、このプロパティは Event インターフェイスで定義しています。詳しくは バグ 1298970 をご覧ください。
[2] isChar プロパティは Firefox 以外のどのブラウザーもサポートしておらず、また Firefox でも Mac OSX 以外では動作しません。このため、ほかのブラウザーに合わせて Firefox 55 で削除しました。