0.6.x/js/01_core/15_XEventDispatcher.js

   1 /**\r
   2  * <p>EventDispatcher インスタンスのメンバ(_listeners)でイベントリスナをイベント名(string)や\r
   3  * イベントID(5~以上の number, フレームワーク内で定義、5 以上になる理由は後述)をキーとする Array で記憶します。\r
   4  * \r
   5  * <p>Arrayには、__CallbackHash__ というハッシュ、または関数が蓄えられています。\r
   6  * \r
   7  * <p>また、イベントターゲット(EventDispatcher[ '_rawObject' ])に渡された再利用可能クロージャの控えを _listeners[0] に記憶します。(ACTUAL_HANDLER)\r
   8  * \r
   9  * <p>dispatch 中の状態と操作を記録し不整合が起きないようにするためのプロパティ(_listeners[1]～_listeners[4])を持ちます。イベントID が 5 から始まるのはこのためです。\r
  10  * \r
  11  * <dl>\r
  12  * <dt>0:ACTUAL_HANDLER\r
  13  * <dd>イベントターゲットの addEventListener 等に渡される実際の関数(多くの場合、再利用可能クロージャ、それ以外は通常の関数)を控えています。\r
  14  * <dt>1:DISPATCHING number\r
  15  * <dd>dispatch 中か？さらにインスタンス自身の dispatch がネストした場合、その深さを記憶します。\r
  16  * <dt>2:RESERVES Array\r
  17  * <dd>イベント発火中に listen() が呼ばれた場合に引数を蓄え、完了時(DISPATCHING===0)に再度 listen() するための一時ストアです。\r
  18  * <dt>3:UNLISTENS Array\r
  19  * <dd>イベント発火中に unlisten() が呼ばれた場合に対象リスナを記憶し、リスナが呼ばれないようにします。完了時(DISPATCHING===0)に再度 unlisten() します。\r
  20  * <dt>4:KILL_RESERVED boolean\r
  21  * <dd>dispatch 中に kill() が呼ばれた場合に一旦 kill をキャンセルし、完了時(DISPATCHING===0)に再度 kill() するためのフラグです。\r
  22  * </dl>\r
  23  * \r
  24  * @class __Listeners__\r
  25  * @private\r
  26  */\r
  27 var X_Listeners_;\r
  28 \r
  29 var /** @const */\r
  30         X_LISTENERS_ACTUAL_HANDLER = 0,\r
  31         /** @const */\r
  32         X_LISTENERS_DISPATCHING    = 1,\r
  33         /** @const */\r
  34         X_LISTENERS_RESERVES       = 2,\r
  35         /** @const */\r
  36         X_LISTENERS_UNLISTENS      = 3,\r
  37         /** @const */\r
  38         X_LISTENERS_KILL_RESERVED  = 4; // X.Event で、イベントIDを 5 から始めているので注意。\r
  39 \r
  40 \r
  41 // ------------------------------------------------------------------------- //\r
  42 // ------------ local variables -------------------------------------------- //\r
  43 // ------------------------------------------------------------------------- //\r
  44 \r
  45 var X_EventDispatcher_once       = false,\r
  46         X_EventDispatcher_lock       = false,\r
  47         X_EventDispatcher_unlock     = false,\r
  48         X_EventDispatcher_needsIndex = false,\r
  49         \r
  50         X_EventDispatcher_safariPreventDefault = false, // Safari3-\r
  51         \r
  52         /* @const */\r
  53         X_EventDispatcher_EVENT_TARGET_OTHER        = 0,\r
  54         /* @const */\r
  55         X_EventDispatcher_EVENT_TARGET_XHR          = 1,\r
  56         /* @const */\r
  57         X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT = 2,\r
  58         \r
  59         X_EventDispatcher_LAZY_TIMERS = {}; // Object.<number, X.EventDispatcher> number は timerID\r
  60 \r
  61 // ------------------------------------------------------------------------- //\r
  62 // --- interface ----------------------------------------------------------- //\r
  63 // ------------------------------------------------------------------------- //\r
  64 \r
  65 /**\r
  66  * <p>ぺったんR フレームワークの特徴であるイベントリスナの作法は次の記事で詳しく解説しています。\r
  67  *      <a href="http://outcloud.blogspot.jp/2015/06/eventdispatcher.html" target="_blank">ぺったんRフレームワークのコールバックのお作法</a>\r
  68  * \r
  69  * <ol>\r
  70  * <li>as3 の EventDispatcher ライクなクラス。そのまま使ったり、継承したり。\r
  71  * <li>_rawObject メンバがいる場合、addEventListener, attachEvent, on 等で生のブラウザオブジェクトにリスナを登録する。\r
  72  *     window, document, HTMLElement, Image, XHR, Silverlight などが _rawObject になる。\r
  73  * <li>イベントディスパッチ中にリスナの追加が呼び出された場合、リスナはこれ以降のイベントから呼ばれます。同様にリスナの削除が呼ばれた場合、そのリスナが呼ばれることはありません。\r
  74  * </ol>\r
  75  * <p>listen, unlisten, dispatch という addEventListener, removeEventListener, dispatchEvent に対応する関数を持ちます。\r
  76  * また listening という ActionScript3 の hasEventListener に相当する関数を持ちます。\r
  77  * \r
  78  * <p>イベントターゲットオブジェクト(widnow, document, HTMLElement, XHR, Silverlight 等)が this[ '_rawObject' ] に設定されていた場合に、それらへ実際のイベント登録・解除も行います。\r
  79  * このイベントの登録・解除はクロスブラウザで、IE5～8 の独自イベントの差異を吸収し、DOM0 に対しても複数のコールバックを登録することができます。\r
  80  * \r
  81  * <p>またコールバックに対して、this コンテキストや、追加の引数を指定もできます。 this コンテキストを指定しなかった場合、EventDispatcher インスタンスがコールバックの this になります。 \r
  82  * \r
  83  * <p>unlisten() では systemListen 経由で登録されたハンドラは解除されません。\r
  84  * \r
  85  * systemListen, systemUnlisten は、ライブラリ内のコードからしかアクセスできません。\r
  86  * \r
  87  * @alias X.EventDispatcher\r
  88  * @class EventDispatcher オブジェクトをラップしたり、アプリケーションで独自に定義したイベントを発信するためのクラスです。\r
  89  * @constructor \r
  90  * @constructs EventDispatcher\r
  91  * @extends {__ClassBase__}\r
  92  */\r
  93 var X_EventDispatcher = X[ 'EventDispatcher' ] =\r
  94         X_Class_create(\r
  95                 'EventDispatcher',\r
  96                 \r
  97             /** @lends EventDispatcher.prototype */\r
  98                 {\r
  99 \r
 100                 /**\r
 101                  * OTHER(Node,window,document,Image,Audio), XHR, Silverlight\r
 102                  * @private\r
 103                  * @type {number}\r
 104                  */\r
 105                         '_rawType'      : X_EventDispatcher_EVENT_TARGET_OTHER,\r
 106                 \r
 107                 /**\r
 108                  * イベントリスナをイベント名文字列や数値(5以上、フレームワーク内で定義)をキーとするArrayで記憶します。<br>\r
 109                  * Arrayには、{kind:種類,context:コンテキスト(thisObject),func:コールバック関数,supplement:サプリメントする引数の配列} というハッシュ、または関数が蓄えられています。\r
 110                  * \r
 111                  * @private\r
 112                  * @type {__Listeners__}\r
 113                  */\r
 114                         '_listeners'    : null,\r
 115 \r
 116                 /**\r
 117                  * _rawObject には HTMLElement, window, document, XHR といったイベントターゲットオブジェクトを設定します。\r
 118                  * _rawObject が設定されていると listen(), unlisten() 時に addEventListener(DOM Level2) や detachEvent(ie5～8), on～(DOM0) 等を操作します。\r
 119                  * _rawObject は最初の listen() 前に設定しておかないと addEventListener 等が意図したように行われません。\r
 120                  * X.Node では非同期に HTMLElement を生成していますが、要素生成以前に listen, unlisten を呼び出すことができます。これは適宜に X_EventDispatcher_toggleAllEvents を呼んで解決しているためです。\r
 121                  * @private\r
 122                  * @type {Object}\r
 123                  */\r
 124                         '_rawObject'    : null,\r
 125                         \r
 126             /**\r
 127              * X.EventDispatcher のコンストラクタの実体。<br>\r
 128                  * イベントターゲットをラップする場合、通常は new 時に渡します。<br>\r
 129                  * アプリケーション独自のイベントをやり取りしたいだけ、という場合イベントターゲットは指定しません。\r
 130              * @param {object=} opt_rawObject\r
 131              */\r
 132                         'Constructor' : function( opt_rawObject ){\r
 133                                 if( opt_rawObject ){\r
 134                                         this[ '_rawObject' ] = opt_rawObject;\r
 135                                 };\r
 136                         },\r
 137 \r
 138                         'dispatch' : X_EventDispatcher_dispatch,\r
 139                         \r
 140                         'listen' : X_EventDispatcher_listen,\r
 141                 \r
 142                 /**\r
 143                  * dispatch 時に自動で unlisten されるフラグを立てて listen する。\r
 144                  * @param {string|number|Array.<string,number>} type 配列を指定した場合、複数のイベントタイプに対して同じコールバックを登録する。\r
 145                  * @param {listener|function|Array} [opt_arg1=]\r
 146                  * @param {function|Array} [opt_arg2=]\r
 147                  * @param {Array} [opt_arg3=] コールバック時の引数を配列に入れる。引数がひとつでも配列を使用する。省略した場合引数なし。unlisten() に使用するので、配列も適宜に保持しておくこと。\r
 148                  * @return {EventDispatcher} チェインメソッド\r
 149                  */\r
 150                         'listenOnce' : function( type, opt_arg1, opt_arg2, opt_arg3 ){\r
 151                                 X_EventDispatcher_once = true;\r
 152                                 this[ 'listen' ]( type, opt_arg1, opt_arg2, opt_arg3 );\r
 153                                 X_EventDispatcher_once = false;\r
 154                                 return this;\r
 155                         },\r
 156 \r
 157                         'unlisten' : X_EventDispatcher_unlisten,\r
 158 \r
 159                 /**\r
 160                  * <p>イベントリスナの登録状況を真偽値で返す。戻り値が数値(index)の場合もあるが、これは内部のみで使用。\r
 161                  * <p>this.listening(); のように type を省略した場合、一つでも登録があれば true を返す。\r
 162                  * <p>this.listening( 'myevent' ); と type だけを与えた場合、その type に登録があれば true を返す。\r
 163                  * <p>type と イベントリスナの組み合わせが登録されているかを調べる場合は、listen 時の thisObject や args(Array) も一致させて渡す必要がある。\r
 164                  * \r
 165                  * @example \r
 166                  *  this.listen( [ 'myevent', 'yourevent' ], this, onMyEvent, args = [ 1, 'a' ] );\r
 167                  *  this.listening( 'myevent', this, onMyEvent, args ) === true;\r
 168                  * \r
 169                  * @return {number|boolean}\r
 170                  * @param {string|number} opt_type\r
 171                  * @param {listener|function|Array|callbackHash} opt_arg1\r
 172                  * @param {function|Array} opt_arg2\r
 173                  * @param {Array} opt_arg3\r
 174                  */                     \r
 175                         'listening' : function( opt_type, opt_arg1, opt_arg2, opt_arg3 ){\r
 176                                 var listeners = this[ '_listeners' ],\r
 177                                         lock      = X_EventDispatcher_lock || X_EventDispatcher_unlock,\r
 178                                         list, cbHash, unlistens, i, f;\r
 179                                 \r
 180                                 if( opt_type === undefined ) return !!listeners;\r
 181                                 if( !listeners || !( list = listeners[ opt_type ] ) ) return false;\r
 182                                 if( opt_arg1 === undefined ) return X_EventDispatcher_needsIndex ? 0 : true;\r
 183                                 \r
 184                                 // TODO callbackHash か？判定が不十分！\r
 185                                 if( opt_arg1.kind ){\r
 186                                         cbHash = opt_arg1;\r
 187                                 } else {\r
 188                                         cbHash = X_Callback_classifyCallbackArgs( opt_arg1, opt_arg2, opt_arg3, this );\r
 189                                 };\r
 190                                 \r
 191                                 if( ( unlistens = listeners[ X_LISTENERS_UNLISTENS ] ) && ( unlistens = unlistens[ opt_type ] ) ){\r
 192                                         for( i = unlistens.length; i; ){\r
 193                                                 f = unlistens[ --i ];\r
 194                                                 if( f === cbHash || ( f.context === cbHash.context && f.func === cbHash.func && f.name === cbHash.name && f.supplement === cbHash.supplement && f.lock === lock ) ) return false;\r
 195                                         };\r
 196                                 };\r
 197                                 for( i = list.length; i; ){\r
 198                                         f = list[ --i ];\r
 199                                         if( f === cbHash || ( f.context === cbHash.context && f.func === cbHash.func && f.name === cbHash.name && f.supplement === cbHash.supplement && f.lock === lock ) ){\r
 200                                                 // index を要求された場合、lock されていない、または unlock なら index を返す\r
 201                                                 return X_EventDispatcher_needsIndex ? i : true;\r
 202                                         };\r
 203                                 };\r
 204                                 return false;\r
 205                         },\r
 206 \r
 207                 /**\r
 208                  * delay(ミリ秒)後にイベントを dispatch する。戻り値は uid = X.Timer.once() のタイマーID(数値)。X.Timer.remove(uid) でタイマーを解除して dispatch を中止できる。\r
 209                  * kill() 時には内部でまだ呼ばれていないタイマーの X.Timer.remove() が行われる。インスタンスが破棄された後にタイマーが呼ばれることがないので神経質にならなくても安全に使える。\r
 210                  * @example this[ 'asyncDispatch' ]( 'myevent' );\r
 211                  * // どちらのコードも同じ動作をする。\r
 212                  * this.asyncDispatch( 0, 'myevent' );\r
 213                  * @param {number|eventHash|string} delay ms 省略した場合は 0 として扱う asyncDispatch( 'myevent' ) -> asyncDispatch( 0, 'myevent' )\r
 214                  * @param {eventHash|string|number} e イベントを表す数値、文字列、{ type : XXX, ... } なオブジェクト\r
 215                  * @return {number} X.Timer.add() の戻り値\r
 216                  */                     \r
 217                         'asyncDispatch' : function( delay, e ){\r
 218                                 var timerID;\r
 219                                 if( delay && e === undefined ){\r
 220                                         e = delay;\r
 221                                         delay = 0;\r
 222                                 };\r
 223                                 timerID = X_Timer_add( delay, 1, this, X_EventDispatcher_dispatch, [ e ] );\r
 224                                 X_EventDispatcher_LAZY_TIMERS[ timerID ] = this;\r
 225                                 return timerID;\r
 226                         }\r
 227                 }\r
 228         );\r
 229 \r
 230 // ------------------------------------------------------------------------- //\r
 231 // --- implements ---------------------------------------------------------- //\r
 232 // ------------------------------------------------------------------------- //\r
 233 \r
 234 /**\r
 235  * 登録されたイベントリスナを呼び出す。イベントリスナの返り値(数値)を OR したものを返す。イベントハッシュでなく、string|number を渡すと内部でイベントハッシュを作る。\r
 236  * dispatch のコールバック中で kill() が呼ばれた場合、実際の kill は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で kill() する。__ClassBase__ も参照。\r
 237  * dispatch のコールバック中で listen() が呼ばれた場合、実際の listen は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で listen() する。\r
 238  * dispatch のコールバック中で unlisten() が呼ばれた場合、即座に反映され削除されたイベントリスナーは呼ばれない。\r
 239  * @alias EventDispatcher.prototype.dispatch\r
 240  * @param {eventHash|string|number} e\r
 241  * @return {number} X.Callback で定義された数値(ビットフラグ)\r
 242  */\r
 243 function X_EventDispatcher_dispatch( e ){\r
 244         var listeners = this[ '_listeners' ],\r
 245                 ret       = X_Callback_NONE,\r
 246                 type      = e[ 'type' ],\r
 247                 list, unlistens, i, l, args, f, r, sysOnly, timerID;\r
 248         \r
 249         if( !listeners || !( list = listeners[ type || e ] ) ) return X_Callback_NONE;\r
 250         \r
 251         // 数値, 文字が渡された場合\r
 252         if( !type ){\r
 253                 e = { 'type' : type = e };\r
 254         };\r
 255         e[ 'target' ]        = e[ 'target' ] || this;\r
 256         e[ 'currentTarget' ] = e[ 'currentTarget' ] || this;\r
 257         \r
 258         if( listeners[ X_LISTENERS_DISPATCHING ] ){\r
 259                 ++listeners[ X_LISTENERS_DISPATCHING ];\r
 260         } else {\r
 261                 listeners[ X_LISTENERS_DISPATCHING ] = 1;\r
 262         };\r
 263         \r
 264         // todo:\r
 265         // type も保存\r
 266         listeners[ X_LISTENERS_UNLISTENS ] = listeners[ X_LISTENERS_UNLISTENS ] || {};\r
 267         unlistens = listeners[ X_LISTENERS_UNLISTENS ][ type ];\r
 268         \r
 269         for( i = 0; i < list.length; ++i ){\r
 270                 f = list[ i ];\r
 271                 if( !unlistens ){\r
 272                         unlistens = listeners[ X_LISTENERS_UNLISTENS ][ type ];\r
 273                 };\r
 274                 if( unlistens && unlistens.indexOf( f ) !== -1 ) continue;\r
 275                 \r
 276                 r = X_Callback_proxyCallback( f, args || ( args = [ e ] ) ) || 0;\r
 277                 \r
 278                 if( f.once || r & X_Callback_UN_LISTEN ){\r
 279                         // dispatch 中に unlisten が作られることがある\r
 280                         if( !unlistens ){\r
 281                                 unlistens = listeners[ X_LISTENERS_UNLISTENS ] || ( listeners[ X_LISTENERS_UNLISTENS ] = {} );\r
 282                                 unlistens = unlistens[ type ] || ( unlistens[ type ] = [] );\r
 283                         };\r
 284                         unlistens.indexOf( f ) === -1 && ( unlistens[ unlistens.length ] = f );\r
 285                 };\r
 286                 ret |= X_Type_isFinite( r ) ? r : 0;\r
 287                 \r
 288                 if( ( r & X_Callback_STOP_NOW ) === X_Callback_STOP_NOW ){ // iOS では ( & ) 括弧が無いと判定を誤る\r
 289                         sysOnly = true;\r
 290                         break;\r
 291                 };\r
 292         };\r
 293         \r
 294         if( ( --listeners[ X_LISTENERS_DISPATCHING ] ) === 0 ){\r
 295 \r
 296                 delete listeners[ X_LISTENERS_DISPATCHING ];\r
 297                 \r
 298                 // dispatch 中に listen されたイベントの追加\r
 299                 if( list = listeners[ X_LISTENERS_RESERVES ] ){\r
 300                         for( i = 0, l = list.length; i < l; ++i ){\r
 301                                 f = list[ i ];\r
 302                                 X_EventDispatcher_once = f[ 4 ];\r
 303                                 X_EventDispatcher_lock = f[ 5 ];\r
 304                                 this[ 'listen' ]( f[ 0 ], f[ 1 ], f[ 2 ], f[ 3 ] );     \r
 305                                 f.length = 0;\r
 306                         };\r
 307                         list.length = 0;\r
 308                         X_EventDispatcher_once = X_EventDispatcher_lock = false;\r
 309                         delete listeners[ X_LISTENERS_RESERVES ];\r
 310                 };              \r
 311                 \r
 312                 // dispatch 中に unlisten されたイベントの削除\r
 313                 if( unlistens = listeners[ X_LISTENERS_UNLISTENS ] ){\r
 314                         delete listeners[ X_LISTENERS_UNLISTENS ];\r
 315                         \r
 316                         // _unlistens に入っている callbackHash は、lock をクリアしている\r
 317                         X_EventDispatcher_unlock = true;\r
 318                         for( type in unlistens ){\r
 319                                 //if( X_EMPTY_OBJECT[ type ] ) continue;\r
 320                                 list = unlistens[ type ];\r
 321                                 for( i = list.length; i; ){\r
 322                                         this[ 'unlisten' ]( type, list[ --i ] );\r
 323                                 };\r
 324                                 list.length = 0;\r
 325                                 delete unlistens[ type ];\r
 326                         };\r
 327                         X_EventDispatcher_unlock = false;\r
 328                 };\r
 329                 \r
 330                 if( X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ] === this ){\r
 331                         delete X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ];\r
 332                 };\r
 333 \r
 334                 if( listeners[ X_LISTENERS_KILL_RESERVED ] ){\r
 335                         this[ 'kill' ]();\r
 336                 };\r
 337         };\r
 338         \r
 339         return ret;\r
 340 };\r
 341 \r
 342 /**\r
 343  * イベントリスナを追加する。同一イベントに対して重複するリスナ(context, function, 引数 array が一致)の追加は無視される。\r
 344  * ユーザーが触ることは無いが、システム内部でロックフラグを立てたリスナは、立てられていないフラグとは区別される。\r
 345  * この仕組みによってシステムの登録したリスナを、システム外から不用意に削除されることを回避する。\r
 346  * @example // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数を渡す。\r
 347  * this[ 'listen' ]( 'myEvent', context, func );\r
 348  * // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数と追加の引数を渡す。\r
 349  * args = [ 'arg1', 'arg2', 3 ]; // unlisten(　'myEvent', context, func, args　) で使用するので Array も控えておく。\r
 350  * this[ 'listen' ]( 'myEvent', context, func, args );\r
 351  * // 'myEvent' に対して、 listener オブジェクトを渡す。listener は handleEvent という関数を持つオブジェクトのこと。\r
 352  * listener.handleEvent = function( e ){};\r
 353  * this[ 'listen' ]( 'myEvent', listener );\r
 354  * // 'myEvent' に対して、 listener オブジェクトと追加の引数を渡す。\r
 355  * listener.handleEvent = function( e, arg1, arg2, arg3 ){};\r
 356  * this[ 'listen' ]( 'myEvent', listener, [ arg1, arg2, arg3 ] );\r
 357  * // 'myEvent' に対して、 function を渡す。\r
 358  * this[ 'listen' ]( 'myEvent', onMyEvent );\r
 359  * // 'myEvent' に対して、 function と追加の引数を渡す。\r
 360  * this[ 'listen' ]( 'myEvent', onMyEvent, args );\r
 361  * // 次の二つは同じ動作です。 this コンテキストが与えられなかった場合、コールバックの this は発火元インスタンスになります。\r
 362  * this[ 'listen' ]( 'myEvent', this [, func [, args ] ] );\r
 363  * this[ 'listen' ]( 'myEvent' [, func [, args ] ] );\r
 364  * // 複数のイベントタイプを同時に登録。コールバックは同じ指定が使われる。\r
 365  * this[ 'listen' ]( [ 'open', 'close', 'ready' ], onUpdate );\r
 366  * \r
 367  * @alias EventDispatcher.prototype.listen\r
 368  * @param {string|number|Array.<string,number>} type 配列を指定した場合、複数のイベントタイプに対して同じコールバックを登録する。\r
 369  * @param {listener|function|Array} [opt_arg1=]\r
 370  * @param {function|Array} [opt_arg2=]\r
 371  * @param {Array} [opt_arg3=] コールバック時の引数を配列に入れる。引数がひとつでも配列を使用する。省略した場合引数なし。\r
 372  * @return {EventDispatcher} チェインメソッド\r
 373  */\r
 374 function X_EventDispatcher_listen( type, opt_arg1, opt_arg2, opt_arg3 ){\r
 375         var listeners = this[ '_listeners' ],\r
 376                 i, raw, add, list, f;\r
 377 \r
 378         if( !type ) return this;\r
 379         \r
 380         if( listeners && listeners[ X_LISTENERS_DISPATCHING ] ){\r
 381                 if( !listeners[ X_LISTENERS_RESERVES ] ) listeners[ X_LISTENERS_RESERVES ] = [];\r
 382                 listeners[ X_LISTENERS_RESERVES ][ listeners[ X_LISTENERS_RESERVES ].length ] = [ type, opt_arg1, opt_arg2, opt_arg3, X_EventDispatcher_once, X_EventDispatcher_lock ];\r
 383                 return this;\r
 384         };\r
 385         \r
 386         if( X_Type_isArray( type ) ){\r
 387                 for( i = type.length; i; ){\r
 388                         this[ 'listen' ]( type[ --i ], opt_arg1, opt_arg2, opt_arg3 );\r
 389                 };\r
 390                 return this;\r
 391         };\r
 392         \r
 393         raw = this[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
 394         add = raw && ( !listeners || !listeners[ type ] ) && X_Type_isString( type );\r
 395 \r
 396         if( this[ 'listening' ]( type, opt_arg1 || this, opt_arg2, opt_arg3 ) ) return this;\r
 397 \r
 398         if( !listeners ) listeners = this[ '_listeners' ] = {};\r
 399         list = listeners[ type ] || ( listeners[ type ] = [] );\r
 400         \r
 401         add && X_EventDispatcher_actualAddEvent( this, type, raw, list );\r
 402         \r
 403         f = X_Callback_classifyCallbackArgs( opt_arg1, opt_arg2, opt_arg3, this );\r
 404         list[ list.length ] = f;\r
 405         f.once = X_EventDispatcher_once;\r
 406         f.lock = X_EventDispatcher_lock;\r
 407         \r
 408         return this;\r
 409 };\r
 410 \r
 411 /*\r
 412  * X_EventDispatcher_systemUnlisten 経由でないと解除できないリスナの登録\r
 413  */\r
 414 function X_EventDispatcher_systemListen( that, type, opt_arg1, opt_arg2, opt_arg3 ){\r
 415         X_EventDispatcher_lock = true;\r
 416         that[ 'listen' ]( type, opt_arg1, opt_arg2, opt_arg3 );\r
 417         X_EventDispatcher_lock = false;\r
 418 };\r
 419 \r
 420 /**\r
 421  * イベントリスナの解除を行う。登録時と同じ引数を与える必要がある。kill() ですべてのイベントが解除されるので、途中で解除されるイベント以外は kill() に任せてしまってよい。\r
 422  * @alias EventDispatcher.prototype.unlisten\r
 423  * @return {EventDispatcher}\r
 424  * @param {string|number|Array.<string,number>} opt_type イベントID, イベント名、またはその配列\r
 425  * @param {listener|function|Array} opt_arg1\r
 426  * @param {function|Array} opt_arg2\r
 427  * @param {Array} opt_arg3\r
 428  */\r
 429 function X_EventDispatcher_unlisten( opt_type, opt_arg1, opt_arg2, opt_arg3 ){\r
 430         var listeners = this[ '_listeners' ],\r
 431                 list, reserves, unlistens, i, f, raw, k, empty;\r
 432         if( !listeners ) return this;\r
 433         \r
 434         if( X_Type_isArray( opt_type ) ){\r
 435                 for( i = opt_type.length; i; ){\r
 436                         this[ 'unlisten' ]( opt_type[ --i ], opt_arg1, opt_arg2, opt_arg3 );\r
 437                         if( !opt_type[ i ] ){\r
 438                                 alert( '不正な unlisten Array' );\r
 439                         };\r
 440                 };\r
 441                 return this;\r
 442         };\r
 443 \r
 444         if( reserves = listeners[ X_LISTENERS_RESERVES ] ){\r
 445                 for( i = reserves.length; i; ){\r
 446                         f = reserves[ --i ];\r
 447                         if( f[ 0 ] === opt_type && f[ 1 ] === opt_arg1 && f[ 2 ] === opt_arg2 && f[ 3 ] === opt_arg3 && ( !f[ 5 ] || X_EventDispatcher_unlock ) ){\r
 448                                 reserves.splice( i, 1 );\r
 449                                 if( !reserves.legth ) delete listeners[ X_LISTENERS_RESERVES ];\r
 450                                 return this;\r
 451                         };\r
 452                 };\r
 453         };\r
 454         \r
 455         X_EventDispatcher_needsIndex = true;\r
 456         i = this[ 'listening' ]( opt_type, opt_arg1, opt_arg2, opt_arg3 );\r
 457         X_EventDispatcher_needsIndex = false;\r
 458         if( i === false ) return this;\r
 459 \r
 460         f = ( list = listeners[ opt_type ] )[ i ];\r
 461         \r
 462         if( unlistens = listeners[ X_LISTENERS_UNLISTENS ] ){\r
 463                 // _unlistens に入っている callbackHash は、lock のチェックは済んでいる\r
 464                 ( unlistens = unlistens[ opt_type ] ) ?\r
 465                         ( unlistens[ unlistens.length ] = f ) :\r
 466                         ( listeners[ X_LISTENERS_UNLISTENS ][ opt_type ] = [ f ] );\r
 467         } else {\r
 468                 delete f.once;\r
 469                 if( list.length !== 1 ){\r
 470                         list.splice( i, 1 );\r
 471                 } else {\r
 472                         list.length = 0;\r
 473 \r
 474                         delete listeners[ opt_type ];\r
 475 \r
 476                         // TODO カウンター\r
 477                         empty = true;\r
 478                         for( k in listeners ){\r
 479                                 if( k <= X_LISTENERS_KILL_RESERVED ) continue;\r
 480                                 empty = false;\r
 481                                 break;\r
 482                         };\r
 483 \r
 484                         if( !X_String_isNumberString( '' + opt_type ) ){ // 数字イベントの除外\r
 485                                 raw = this[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
 486                                 raw && X_EventDispatcher_actualRemoveEvent( this, opt_type, raw, list, !empty );\r
 487                         };\r
 488                         \r
 489                         if( empty ) delete this[ '_listeners' ];\r
 490                 };\r
 491         };\r
 492         return this;\r
 493 };\r
 494 \r
 495 /*\r
 496  * X_EventDispatcher_systemListen から登録したイベントの解除\r
 497  */\r
 498 function X_EventDispatcher_systemUnlisten( that, type, opt_arg1, opt_arg2, opt_arg3 ){\r
 499         X_EventDispatcher_unlock = true;\r
 500         that[ 'unlisten' ]( type, opt_arg1, opt_arg2, opt_arg3 );\r
 501         X_EventDispatcher_unlock = false;\r
 502 };\r
 503 \r
 504 function X_EventDispatcher_unlistenAll( that ){\r
 505         var listeners = that[ '_listeners' ],\r
 506                 type, list, i;\r
 507         if( !listeners ) return;\r
 508         \r
 509         for( type in listeners ){\r
 510                 //if( X_EMPTY_OBJECT[ opt_type ] ) continue;\r
 511                 if( type <= X_LISTENERS_KILL_RESERVED ) continue;\r
 512                 list = listeners[ type ];\r
 513                 for( i = list.length; i; ){\r
 514                         that[ 'unlisten' ]( type, list[ --i ] );\r
 515                 };\r
 516         };\r
 517 };\r
 518 \r
 519 function X_EventDispatcher_actualAddEvent( that, type, raw, list ){\r
 520         var i, f;\r
 521         X_EventDispatcher_lock || ( type = X_Event_Rename[ type ] || type );\r
 522         \r
 523         if( X_Type_isArray( type ) ){\r
 524                 for( i = type.length; i; ){\r
 525                         X_EventDispatcher_systemListen( that, type[ --i ], X_emptyFunction );\r
 526                         console.log( 'events fix > ' + type[ i ] );\r
 527                 };\r
 528         } else {\r
 529                 \r
 530         // Days on the Moon DOM Events とブラウザの実装 \r
 531         // http://nanto.asablo.jp/blog/2007/03/23/1339502\r
 532         // Safari 2 では関数オブジェクトしか EventListener として使えませんが、Safari のナイトリービルドでは handleEvent メソッドを持つオブジェクトも EventListener として使えるようです。\r
 533                 \r
 534                 if( X_UA_EVENT.W3C ){\r
 535                         switch( that[ '_rawType' ] ){\r
 536                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 537                                         list.slcallback = X_Callback_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
 538                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
 539                                         break;\r
 540                                 \r
 541                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 542                                         if( X_UA[ 'Opera' ] < 12 ){\r
 543                                                 // Opera11- の XHR は event オブジェクトが返らないため, eventType 毎に callback を指定する addEventListener もない\r
 544                                                 raw[ 'on' + type ] = X_Callback_create( that, X_EventDispatcher_dispatch, [ type ] );\r
 545                                                 break;\r
 546                                         };\r
 547 \r
 548                                 default :\r
 549                                         // iOS と MacOSX Iron36 で発生。連続してアニメーションが起こると、クロージャの束縛された obj へのアクセスに失敗する。Win では起きない?\r
 550                                         // むしろ、MacOSX のブラウザ全般で起こる??\r
 551                                         if( ( X_UA[ 'WebKit' ] || X_UA[ 'Blink' ] ) &&\r
 552                                                 ( type === 'webkitTransitionEnd' || type === 'transitionend' ||\r
 553                                                   type === 'animationend'        || type === 'webkitAnimationEnd' ||\r
 554                                                   type === 'animationstart'      || type === 'webkitAnimationStart' ||\r
 555                                                   type === 'animationiteration'  || type === 'webkitAnimationIteration' ) ){\r
 556                                                 raw.addEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
 557                                         } else {\r
 558                                                 f = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
 559                 \r
 560                                                 if( raw.addEventListener ){\r
 561                                                         raw.addEventListener( type, f, false );\r
 562                                                 } else {\r
 563                                                         // Safari は Image, Opera7 は window\r
 564                                                         raw[ 'on' + type ] = f;\r
 565                                                 };\r
 566                                         };\r
 567                         };\r
 568                 } else\r
 569                 if( X_UA_EVENT.IE ){\r
 570                         switch( that[ '_rawType' ] ){   \r
 571                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 572                                         list.slcallback = X_Callback_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
 573                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
 574                                         break;                          \r
 575                                 \r
 576                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 577                                         console.log( 'XHR addEvent ' + type );\r
 578                                         // ie8- の XHR は window.event が更新されないため, eventType 毎に callback を指定する\r
 579                                         raw[ 'on' + type ] = X_Callback_create( that, X_EventDispatcher_dispatch, [ type ] );\r
 580                                         break;\r
 581                                 \r
 582                                 default :\r
 583                                         f = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
 584                                         \r
 585                                         if( raw.attachEvent ){\r
 586                                                 raw.attachEvent( 'on' + type, f );\r
 587                                         } else {\r
 588                                                 raw[ 'on' + type ] = f;\r
 589                                         };\r
 590                                         break;\r
 591                         };\r
 592                 } else {\r
 593                         switch( that[ '_rawType' ] ){\r
 594                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 595                                         // DOM0 で Silverlight ってあるの -> ie4 mobile?\r
 596                                         list.slcallback = X_Callback_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
 597                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
 598                                         break;                          \r
 599                                 \r
 600                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 601                                         // ie4 mobile は XHR をサポート！\r
 602                                         raw[ 'on' + type ] = X_Callback_create( that, X_EventDispatcher_dispatch, [ type ] );\r
 603                                         break;\r
 604 \r
 605                                 default :\r
 606                                         raw[ 'on' + type ] = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
 607                                         break;\r
 608                         };\r
 609                 }\r
 610         };\r
 611 };\r
 612 \r
 613 \r
 614 /*\r
 615  * iOS の webkitTransitionEnd が連続して起こる場合、\r
 616  * コールバックの(that[ X_LISTENERS_ACTUAL_HANDLER ])クロージャ内の実際のコールバック(X_Callback_actualClosure:obj._)が\r
 617  * 参照できていない問題に遭遇、、、iOS3.1.3 & iOS6.1.5 で確認\r
 618  * animation も怪しい、、、\r
 619  */\r
 620 function X_EventDispatcher_iOSTransitionEndDispatch( e ){\r
 621         return X_Node_getXNode( this )[ 'dispatch' ]( X_Event_RenameTo[ e.type ] || e.type );\r
 622 };\r
 623 \r
 624 /*\r
 625  * Silverlight のイベントの概要\r
 626  * http://msdn.microsoft.com/ja-jp/library/cc189018%28v=vs.95%29.aspx#the_sender_parameter_and_event_data\r
 627  */\r
 628 function X_EventDispatcher_sliverLightDispatch( sender, e, type ){\r
 629         return this[ 'dispatch' ]( type );\r
 630 };\r
 631 \r
 632 function X_EventDispatcher_actualRemoveEvent( that, type, raw, list, skip ){\r
 633         var i;\r
 634         X_EventDispatcher_unlock || ( type = X_Event_Rename[ type ] || type );\r
 635         \r
 636         if( X_Type_isArray( type ) ){\r
 637                 for( i = type.length; i; ){\r
 638                         X_EventDispatcher_systemUnlisten( that, type[ --i ], X_emptyFunction );\r
 639                 };\r
 640         } else {\r
 641                 if( X_UA_EVENT.W3C ){\r
 642                         switch( that[ '_rawType' ] ){\r
 643                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 644                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
 645                                         X_Callback_correct( list.slcallback );\r
 646                                         delete list.sltoken;\r
 647                                         delete list.slcallback;\r
 648                                         break;\r
 649                                 \r
 650                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 651                                         if( X_UA[ 'Opera' ] < 12 ){\r
 652                                                 // Opera11- の XHR は event オブジェクトが返らないため, eventType 毎に callback を指定する addEventListener もない\r
 653                                                 X_Callback_correct( raw[ 'on' + type ] );\r
 654                                                 raw[ 'on' + type ] = '';\r
 655                                                 break;\r
 656                                         };\r
 657 \r
 658                                 default :\r
 659                                         if( ( X_UA[ 'WebKit' ] || X_UA[ 'Blink' ] ) &&\r
 660                                                 ( type === 'webkitTransitionEnd' || type === 'transitionend' ||\r
 661                                                   type === 'animationend'        || type === 'webkitAnimationEnd' ||\r
 662                                                   type === 'animationstart'      || type === 'webkitAnimationStart' ||\r
 663                                                   type === 'animationiteration'  || type === 'webkitAnimationIteration' ) ){\r
 664                                                 raw.removeEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
 665                                         } else                  \r
 666                                         if( raw.addEventListener ){\r
 667                                                 raw.removeEventListener( type, that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ], false );\r
 668                                         } else {\r
 669                                                 raw[ 'on' + type ] = null;\r
 670                                         };\r
 671                                         \r
 672                                         if( !skip && that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] ){\r
 673                                                 X_Callback_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
 674                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
 675                                         };\r
 676                         };\r
 677                 } else\r
 678                 if( X_UA_EVENT.IE ){\r
 679                         switch( that[ '_rawType' ] ){\r
 680                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 681                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
 682                                         X_Callback_correct( list.slcallback );\r
 683                                         delete list.sltoken;\r
 684                                         delete list.slcallback;\r
 685                                         break;\r
 686                                 \r
 687                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 688                                         X_Callback_correct( raw[ 'on' + type ] );\r
 689                                         raw[ 'on' + type ] = X_emptyFunction;\r
 690                                         raw[ 'on' + type ] = '';\r
 691                                         console.log( 'XHR rmEvent ' + type );\r
 692                                         break;\r
 693 \r
 694                                 default :\r
 695                                         if( raw.attachEvent ){\r
 696                                                 raw.detachEvent( 'on' + type, that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
 697                                         } else {\r
 698                                                 raw[ 'on' + type ] = X_emptyFunction;\r
 699                                                 raw[ 'on' + type ] = '';\r
 700                                         };\r
 701                                         \r
 702                                         if( !skip ){\r
 703                                                 X_Callback_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
 704                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
 705                                         };\r
 706                         };\r
 707                 } else {\r
 708                         switch( that[ '_rawType' ] ){\r
 709                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
 710                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
 711                                         X_Callback_correct( list.slcallback );\r
 712                                         delete list.sltoken;\r
 713                                         delete list.slcallback;\r
 714                                         break;\r
 715                                 \r
 716                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
 717                                         X_Callback_correct( raw[ 'on' + type ] );\r
 718                                         raw[ 'on' + type ] = X_emptyFunction;\r
 719                                         raw[ 'on' + type ] = '';\r
 720                                         break;\r
 721 \r
 722                                 default :\r
 723                                         raw[ 'on' + type ] = X_emptyFunction;\r
 724                                         raw[ 'on' + type ] = '';\r
 725                                         \r
 726                                         if( !skip ){\r
 727                                                 X_Callback_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
 728                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
 729                                         };\r
 730                         };\r
 731                 };\r
 732         };\r
 733 };\r
 734 \r
 735 \r
 736 // TODO ブラウザからの呼び出しの最後に登録された関数を呼び出す機能(例えば画面の更新)\r
 737 \r
 738 // handleEvent を拡張可能にするために、クロージャに移動した\r
 739 // Is this in regard to the Safari 1.x preventDefault bug on click/dblclick?\r
 740 // https://groups.google.com/forum/#!msg/comp.lang.javascript/uYEuCHjHxnw/yKoHtZJPa1QJ\r
 741 var X_EventDispatcher_actualHandleEvent =\r
 742         X_UA_EVENT.IE4 || X_UA_EVENT.IE ? // ie45678 EVENT_IE & EVENT_DOM0 for ie4\r
 743                 (function(){\r
 744                         var e = event, ret;\r
 745                         \r
 746                         ret = this[ 'dispatch' ]( new X_DomEvent( e, this, this[ '_rawObject' ] ) );\r
 747 \r
 748                         if( ret & X_Callback_STOP_PROPAGATION ){\r
 749                                 e.cancelBubble = true;\r
 750                         };\r
 751                         if( ret & X_Callback_PREVENT_DEFAULT ){\r
 752                                 this[ '_tag' ] === 'A' && this[ '_rawObject' ].blur();\r
 753                                 return e.returnValue = false;\r
 754                         };\r
 755                 }) :\r
 756         //X_UA_EVENT.W3C || X_UA_EVENT.DOM0\r
 757                 (function( e ){\r
 758                         var ev  = new X_DomEvent( e, this ),\r
 759                                 ret = X_Callback_NONE,\r
 760                                 i, l;\r
 761                         //console.log( '>>>>>>>>>> ' + e.type );\r
 762                         // touch event -> pointer\r
 763                         if( X_Type_isArray( ev ) ){\r
 764                                 if( ev.length === 0 ){\r
 765                                         // TouchEvent の後に発生した MouseEvent のｷｬﾝｾﾙ\r
 766                                         ret = X_Callback_STOP_PROPAGATION | X_Callback_PREVENT_DEFAULT;\r
 767                                 } else {\r
 768                                         for( i = 0, l = ev.length; i < l; ++i ){\r
 769                                                 //console.log( 'handleEvent ' + ev[ i ].type );\r
 770                                                 ret |= this[ 'dispatch' ]( ev[ i ] ) || 0;\r
 771                                         };\r
 772                                 };\r
 773                         } else {\r
 774                                 ret = this[ 'dispatch' ]( ev );\r
 775                         };\r
 776                         \r
 777                         if( ret & X_Callback_STOP_PROPAGATION ){\r
 778                                 e.stopPropagation();\r
 779                         };\r
 780                         if( ret & X_Callback_PREVENT_DEFAULT ){\r
 781                                 this[ '_tag' ] === 'A' && this[ '_rawObject' ].blur();\r
 782                                 e.preventDefault();\r
 783                                 if( X_UA[ 'WebKit' ] < 525.13 ){ // Safari3-\r
 784                                         if( e.type === 'click' || e.type === 'dbclick' ){\r
 785                                                 X_EventDispatcher_safariPreventDefault = true;\r
 786                                         };\r
 787                                 };\r
 788                                 return false;\r
 789                         };\r
 790                 });\r
 791 \r
 792 if( X_UA[ 'WebKit' ] < 525.13 ){ // Safari3-\r
 793         document.documentElement.onclick =\r
 794         document.documentElement[ 'ondbclick' ] = function( e ){\r
 795                         if( X_EventDispatcher_safariPreventDefault ){\r
 796                                 X_EventDispatcher_safariPreventDefault = false;\r
 797                                 e.preventDefault();\r
 798                                 return false;\r
 799                         };\r
 800                 };\r
 801 };\r
 802 \r
 803 // イベントの退避、dom が画面から抜かれる場合に実施しておく\r
 804 // 退避したイベントの復帰\r
 805 function X_EventDispatcher_toggleAllEvents( that, add ){\r
 806         var list = that[ '_listeners' ],\r
 807                 raw  = that[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( that ),\r
 808                 func = add ? X_EventDispatcher_actualAddEvent : X_EventDispatcher_actualRemoveEvent,\r
 809                 type;\r
 810         if( !list || !raw ) return;\r
 811         for( type in list ){\r
 812                 //if( X_EMPTY_OBJECT[ type ] ) continue;\r
 813                 //if( type <= X_LISTENERS_KILL_RESERVED ) continue;\r
 814                 // 数字イベントの除外\r
 815                 if( !X_String_isNumberString( type ) ){\r
 816                         // TODO type rename はここ\r
 817                         func( that, type, raw, list[ type ], true );\r
 818                 };\r
 819         };\r
 820 };\r
 821 \r
 822 \r
 823 console.log( 'X.Core.EventDispatcher' );\r