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