OSDN Git Service

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