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 の定義 |
廃止された | 最初の定義 |
ブラウザー実装状況
現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！
| 機能 | 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 で削除しました。