OSDN Git Service

699c34b47b66774b7a06b8fa61251a85e58001ec
[pettanr/clientJs.git] / 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 Object\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には、{cbKind:種類,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 か?判定が不十分! skipConvertion\r
180                                 if( opt_arg1.cbKind ){\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.funcName === cbHash.funcName && f.supplement === cbHash.supplement && f.lock === lock ) ) return false;\r
190                                         };\r
191                                 };\r
192                                 \r
193                                 for( i = list.length; i; ){\r
194                                         f = list[ --i ];\r
195                                         if( f === cbHash || ( f.context === cbHash.context && f.func === cbHash.func && f.funcName === cbHash.funcName && f.supplement === cbHash.supplement && f.lock === lock ) ){\r
196                                                 // index を要求された場合、lock されていない、または unlock なら index を返す\r
197                                                 return X_EventDispatcher_needsIndex ? i : true;\r
198                                         };\r
199                                 };\r
200                                 return false;\r
201                         },\r
202 \r
203                 /**\r
204                  * delay(ミリ秒)後にイベントを dispatch する。戻り値は uid = X.Timer.once() のタイマーID(数値)。X.Timer.remove(uid) でタイマーを解除して dispatch を中止できる。\r
205                  * kill() 時には内部でまだ呼ばれていないタイマーの X.Timer.remove() が行われる。インスタンスが破棄された後にタイマーが呼ばれることがないので神経質にならなくても安全に使える。\r
206                  * @example this[ 'asyncDispatch' ]( 'myevent' );\r
207                  * // どちらのコードも同じ動作をする。\r
208                  * this.asyncDispatch( 0, 'myevent' );\r
209                  * @param {number|eventHash|string} delay ms 省略した場合は 0 として扱う asyncDispatch( 'myevent' ) -> asyncDispatch( 0, 'myevent' )\r
210                  * @param {eventHash|string|number} e イベントを表す数値、文字列、{ type : XXX, ... } なオブジェクト\r
211                  * @return {number} X.Timer.add() の戻り値\r
212                  */                     \r
213                         'asyncDispatch' : function( delay, e ){\r
214                                 var timerID;\r
215                                 if( delay && e === undefined ){\r
216                                         e = delay;\r
217                                         delay = 0;\r
218                                 };\r
219                                 //{+dev\r
220                                 delay === undefined && eval( 'throw "asyncDispatch で undefined イベントが指定されました"' );\r
221                                 //}+dev\r
222                                 timerID = X_Timer_add( delay, 1, this, X_EventDispatcher_dispatch, [ e ] );\r
223                                 X_EventDispatcher_LAZY_TIMERS[ timerID ] = this;\r
224                                 return timerID;\r
225                         }\r
226                 }\r
227         );\r
228 \r
229 // ------------------------------------------------------------------------- //\r
230 // --- implements ---------------------------------------------------------- //\r
231 // ------------------------------------------------------------------------- //\r
232 \r
233 /**\r
234  * 登録されたイベントリスナを呼び出す。イベントリスナの返り値(数値)を OR したものを返す。イベントハッシュでなく、string|number を渡すと内部でイベントハッシュを作る。\r
235  * dispatch のコールバック中で kill() が呼ばれた場合、実際の kill は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で kill() する。__ClassBase__ も参照。\r
236  * dispatch のコールバック中で listen() が呼ばれた場合、実際の listen は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で listen() する。\r
237  * dispatch のコールバック中で unlisten() が呼ばれた場合、即座に反映され削除されたイベントリスナーは呼ばれない。\r
238  * @alias EventDispatcher.prototype.dispatch\r
239  * @param {eventHash|string|number} e\r
240  * @return {number} X.Callback で定義された数値(ビットフラグ)\r
241  */\r
242 function X_EventDispatcher_dispatch( e ){\r
243         var listeners = this[ '_listeners' ],\r
244                 ret       = X_CALLBACK_NONE,\r
245                 type      = e[ 'type' ],\r
246                 list, unlistens, i, l, args, f, r, sysOnly, timerID, k;\r
247         \r
248         if( !listeners || !( list = listeners[ type || e ] ) ) return X_CALLBACK_NONE;\r
249         \r
250         // 数値, 文字が渡された場合\r
251         if( !type ){\r
252                 e = { 'type' : type = e };\r
253         };\r
254         e[ 'target' ]        = e[ 'target' ] || this;\r
255         e[ 'currentTarget' ] = e[ 'currentTarget' ] || this;\r
256         \r
257         if( listeners[ X_LISTENERS_DISPATCHING ] ){\r
258                 ++listeners[ X_LISTENERS_DISPATCHING ];\r
259         } else {\r
260                 listeners[ X_LISTENERS_DISPATCHING ] = 1;\r
261         };\r
262 \r
263         //listeners[ X_LISTENERS_UNLISTENS ] = listeners[ X_LISTENERS_UNLISTENS ] || {};\r
264         //unlistens = listeners[ X_LISTENERS_UNLISTENS ][ type ];\r
265         \r
266         for( i = 0; i < list.length; ++i ){\r
267                 f = list[ i ];\r
268                 // TODO removed フラグは?\r
269                 if( f.removed ) continue;\r
270                 /*\r
271                 if( !unlistens ){\r
272                         unlistens = listeners[ X_LISTENERS_UNLISTENS ][ type ];\r
273                 };\r
274                 if( unlistens && unlistens.indexOf( f ) !== -1 ) continue;\r
275                 */\r
276                 \r
277                 r = X_Closure_proxyCallback( f, args || ( args = [ e ] ) );\r
278                 \r
279                 if( f.once || ( r & X_CALLBACK_UN_LISTEN ) ){\r
280                         // dispatch 中に unlisten が作られることがある\r
281                         if( !unlistens ){\r
282                                 unlistens = listeners[ X_LISTENERS_UNLISTENS ] || ( listeners[ X_LISTENERS_UNLISTENS ] = {} );\r
283                                 unlistens = unlistens[ type ] || ( unlistens[ type ] = [] );\r
284                         };\r
285                         unlistens.indexOf( f ) === -1 && ( unlistens[ unlistens.length ] = f );\r
286                 };\r
287                 ret |= X_Type_isFinite( r ) ? r : 0;\r
288                 \r
289                 if( ( r & X_CALLBACK_STOP_NOW ) === X_CALLBACK_STOP_NOW ){ // iOS では ( & ) 括弧が無いと判定を誤る\r
290                         sysOnly = true;\r
291                         break;\r
292                 };\r
293         };\r
294         \r
295         if( ( --listeners[ X_LISTENERS_DISPATCHING ] ) === 0 ){\r
296 \r
297                 delete listeners[ X_LISTENERS_DISPATCHING ];\r
298                 \r
299                 // dispatch 中に listen されたイベントの追加\r
300                 if( list = listeners[ X_LISTENERS_RESERVES ] ){\r
301                         for( i = 0, l = list.length; i < l; ++i ){\r
302                                 f = list[ i ];\r
303                                 X_EventDispatcher_once = f[ 4 ];\r
304                                 X_EventDispatcher_lock = f[ 5 ];\r
305                                 this[ 'listen' ]( f[ 0 ], f[ 1 ], f[ 2 ], f[ 3 ] );     \r
306                                 f.length = 0;\r
307                         };\r
308                         list.length = 0;\r
309                         X_EventDispatcher_once = X_EventDispatcher_lock = false;\r
310                         delete listeners[ X_LISTENERS_RESERVES ];\r
311                 };              \r
312                 \r
313                 // dispatch 中に unlisten されたイベントの削除\r
314                 if( unlistens = listeners[ X_LISTENERS_UNLISTENS ] ){\r
315                         delete listeners[ X_LISTENERS_UNLISTENS ];\r
316                         \r
317                         // _unlistens に入っている callbackHash は、lock をクリアしている\r
318                         X_EventDispatcher_unlock = true;\r
319                         for( k in unlistens ){\r
320                                 //if( X_EMPTY_OBJECT[ k ] ) continue;\r
321                                 list = unlistens[ k ];\r
322                                 for( i = list.length; i; ){\r
323                                         this[ 'unlisten' ]( k, list[ --i ] );\r
324                                 };\r
325                                 list.length = 0;\r
326                                 delete unlistens[ k ];\r
327                         };\r
328                         X_EventDispatcher_unlock = false;\r
329                 };\r
330                 \r
331                 if( X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ] === this ){\r
332                         delete X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ];\r
333                 };\r
334 \r
335                 if( listeners[ X_LISTENERS_KILL_RESERVED ] ){\r
336                         this[ 'kill' ]();\r
337                 };\r
338         };\r
339         \r
340         return ret;\r
341 };\r
342 \r
343 /**\r
344  * イベントリスナを追加する。同一イベントに対して重複するリスナ(context, function, 引数 array が一致)の追加は無視される。\r
345  * ユーザーが触ることは無いが、システム内部でロックフラグを立てたリスナは、立てられていないフラグとは区別される。\r
346  * この仕組みによってシステムの登録したリスナを、システム外から不用意に削除されることを回避する。\r
347  * @example // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数を渡す。\r
348  * this[ 'listen' ]( 'myEvent', context, func );\r
349  * // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数と追加の引数を渡す。\r
350  * args = [ 'arg1', 'arg2', 3 ]; // unlisten( 'myEvent', context, func, args ) で使用するので Array も控えておく。\r
351  * this[ 'listen' ]( 'myEvent', context, func, args );\r
352  * // 'myEvent' に対して、 listener オブジェクトを渡す。listener は handleEvent という関数を持つオブジェクトのこと。\r
353  * listener.handleEvent = function( e ){};\r
354  * this[ 'listen' ]( 'myEvent', listener );\r
355  * // 'myEvent' に対して、 listener オブジェクトと追加の引数を渡す。\r
356  * listener.handleEvent = function( e, arg1, arg2, arg3 ){};\r
357  * this[ 'listen' ]( 'myEvent', listener, [ arg1, arg2, arg3 ] );\r
358  * // 'myEvent' に対して、 function を渡す。\r
359  * this[ 'listen' ]( 'myEvent', onMyEvent );\r
360  * // 'myEvent' に対して、 function と追加の引数を渡す。\r
361  * this[ 'listen' ]( 'myEvent', onMyEvent, args );\r
362  * // 次の二つは同じ動作です。 this コンテキストが与えられなかった場合、コールバックの this は発火元インスタンスになります。\r
363  * this[ 'listen' ]( 'myEvent', this [, func [, args ] ] );\r
364  * this[ 'listen' ]( 'myEvent' [, func [, args ] ] );\r
365  * // 複数のイベントタイプを同時に登録。コールバックは同じ指定が使われる。\r
366  * this[ 'listen' ]( [ 'open', 'close', 'ready' ], onUpdate );\r
367  * \r
368  * @alias EventDispatcher.prototype.listen\r
369  * @param {string|number|Array.<string,number>} type 配列を指定した場合、複数のイベントタイプに対して同じコールバックを登録する。\r
370  * @param {listener|function|Array} [opt_arg1=]\r
371  * @param {function|Array} [opt_arg2=]\r
372  * @param {Array} [opt_arg3=] コールバック時の引数を配列に入れる。引数がひとつでも配列を使用する。省略した場合引数なし。\r
373  * @return {EventDispatcher} チェインメソッド\r
374  */\r
375 function X_EventDispatcher_listen( type, opt_arg1, opt_arg2, opt_arg3 ){\r
376         var listeners = this[ '_listeners' ],\r
377                 i, raw, add, list, f;\r
378 \r
379         if( !type ) return this;\r
380         \r
381         if( listeners && listeners[ X_LISTENERS_DISPATCHING ] ){\r
382                 if( !listeners[ X_LISTENERS_RESERVES ] ) listeners[ X_LISTENERS_RESERVES ] = [];\r
383                 listeners[ X_LISTENERS_RESERVES ][ listeners[ X_LISTENERS_RESERVES ].length ] = [ type, opt_arg1, opt_arg2, opt_arg3, X_EventDispatcher_once, X_EventDispatcher_lock ];\r
384                 return this;\r
385         };\r
386         \r
387         if( X_Type_isArray( type ) ){\r
388                 for( i = type.length; i; ){\r
389                         this[ 'listen' ]( type[ --i ], opt_arg1, opt_arg2, opt_arg3 );\r
390                 };\r
391                 return this;\r
392         };\r
393         \r
394         raw = this[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
395         add = raw && ( !listeners || !listeners[ type ] ) && X_Type_isString( type );\r
396 \r
397         if( this[ 'listening' ]( type, opt_arg1 || this, opt_arg2, opt_arg3 ) ) return this;\r
398 \r
399         if( !listeners ) listeners = this[ '_listeners' ] = {};\r
400         list = listeners[ type ] || ( listeners[ type ] = [] );\r
401         \r
402         add && X_EventDispatcher_actualAddEvent( this, type, raw, list );\r
403         \r
404         f = X_Closure_classifyCallbackArgs( opt_arg1, opt_arg2, opt_arg3, this );\r
405         list[ list.length ] = f;\r
406         f.once = X_EventDispatcher_once;\r
407         f.lock = X_EventDispatcher_lock;\r
408         \r
409         return this;\r
410 };\r
411 \r
412 /*\r
413  * X_EventDispatcher_systemUnlisten 経由でないと解除できないリスナの登録\r
414  */\r
415 function X_EventDispatcher_systemListen( that, type, opt_arg1, opt_arg2, opt_arg3 ){\r
416         X_EventDispatcher_lock = true;\r
417         that[ 'listen' ]( type, opt_arg1, opt_arg2, opt_arg3 );\r
418         X_EventDispatcher_lock = false;\r
419 };\r
420 \r
421 /**\r
422  * イベントリスナの解除を行う。登録時と同じ引数を与える必要がある。kill() ですべてのイベントが解除されるので、途中で解除されるイベント以外は kill() に任せてしまってよい。\r
423  * @alias EventDispatcher.prototype.unlisten\r
424  * @return {EventDispatcher}\r
425  * @param {string|number|Array.<string,number>} opt_type イベントID, イベント名、またはその配列\r
426  * @param {listener|function|Array} opt_arg1\r
427  * @param {function|Array} opt_arg2\r
428  * @param {Array} opt_arg3\r
429  */\r
430 function X_EventDispatcher_unlisten( opt_type, opt_arg1, opt_arg2, opt_arg3 ){\r
431         var listeners = this[ '_listeners' ],\r
432                 list, reserves, unlistens, i, f, raw, k, empty;\r
433 \r
434         if( !listeners ) return this;\r
435         \r
436         if( X_Type_isArray( opt_type ) ){\r
437                 for( i = opt_type.length; i; ){\r
438                         this[ 'unlisten' ]( opt_type[ --i ], opt_arg1, opt_arg2, opt_arg3 );\r
439                         if( !opt_type[ i ] ){\r
440                                 alert( '不正な unlisten Array' );\r
441                         };\r
442                 };\r
443                 return this;\r
444         };\r
445 \r
446         if( reserves = listeners[ X_LISTENERS_RESERVES ] ){\r
447                 for( i = reserves.length; i; ){\r
448                         f = reserves[ --i ];\r
449                         if( f[ 0 ] === opt_type && f[ 1 ] === opt_arg1 && f[ 2 ] === opt_arg2 && f[ 3 ] === opt_arg3 && ( !f[ 5 ] || X_EventDispatcher_unlock ) ){\r
450                                 reserves.splice( i, 1 );\r
451                                 if( !reserves.legth ) delete listeners[ X_LISTENERS_RESERVES ];\r
452                                 return this;\r
453                         };\r
454                 };\r
455         };\r
456         \r
457         X_EventDispatcher_needsIndex = true;\r
458         i = this[ 'listening' ]( opt_type, opt_arg1, opt_arg2, opt_arg3 );\r
459         X_EventDispatcher_needsIndex = false;\r
460         if( i === false ) return this;\r
461 \r
462         f = ( list = listeners[ opt_type ] )[ i ];\r
463         \r
464         if( listeners[ X_LISTENERS_DISPATCHING ] ){\r
465                 unlistens = listeners[ X_LISTENERS_UNLISTENS ] || ( listeners[ X_LISTENERS_UNLISTENS ] = {} );\r
466                 // _unlistens に入っている callbackHash は、lock のチェックは済んでいる\r
467                 ( unlistens = unlistens[ opt_type ] ) ?\r
468                         ( unlistens[ unlistens.length ] = f ) :\r
469                         ( listeners[ X_LISTENERS_UNLISTENS ][ opt_type ] = [ f ] );\r
470                 f.removed = true;\r
471         } else {\r
472                 //delete f.once;\r
473                 X_Object_clear( f );\r
474                 \r
475                 if( list.length !== 1 ){\r
476                         list.splice( i, 1 );\r
477                 } else {\r
478                         list.length = 0;\r
479 \r
480                         delete listeners[ opt_type ];\r
481 \r
482                         // TODO カウンター\r
483                         empty = true;\r
484                         for( k in listeners ){\r
485                                 if( k <= X_LISTENERS_KILL_RESERVED ) continue;\r
486                                 empty = false;\r
487                                 break;\r
488                         };\r
489 \r
490                         if( !X_String_isNumberString( '' + opt_type ) ){ // 数字イベントの除外\r
491                                 raw = this[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
492                                 raw && X_EventDispatcher_actualRemoveEvent( this, opt_type, raw, list, !empty );\r
493                         };\r
494                         \r
495                         if( empty ) delete this[ '_listeners' ];\r
496                 };\r
497         };\r
498         return this;\r
499 };\r
500 \r
501 /*\r
502  * X_EventDispatcher_systemListen から登録したイベントの解除\r
503  */\r
504 function X_EventDispatcher_systemUnlisten( that, type, opt_arg1, opt_arg2, opt_arg3 ){\r
505         X_EventDispatcher_unlock = true;\r
506         that[ 'unlisten' ]( type, opt_arg1, opt_arg2, opt_arg3 );\r
507         X_EventDispatcher_unlock = false;\r
508 };\r
509 \r
510 function X_EventDispatcher_unlistenAll( that ){\r
511         var listeners = that[ '_listeners' ],\r
512                 type, list, i;\r
513         if( !listeners ) return;\r
514         \r
515         for( type in listeners ){\r
516                 //if( X_EMPTY_OBJECT[ opt_type ] ) continue;\r
517                 if( type <= X_LISTENERS_KILL_RESERVED ) continue;\r
518                 list = listeners[ type ];\r
519                 for( i = list.length; i; ){\r
520                         that[ 'unlisten' ]( type, list[ --i ] );\r
521                 };\r
522         };\r
523 };\r
524 \r
525 function X_EventDispatcher_actualAddEvent( that, type, raw, list ){\r
526         var i, f;\r
527         X_EventDispatcher_lock || ( type = X_Event_Rename[ type ] || type );\r
528         \r
529         if( X_Type_isArray( type ) ){\r
530                 for( i = type.length; i; ){\r
531                         X_EventDispatcher_systemListen( that, type[ --i ], X_emptyFunction );\r
532                         console.log( 'events fix > ' + type[ i ] );\r
533                 };\r
534         } else {\r
535                 \r
536         // Days on the Moon DOM Events とブラウザの実装 \r
537         // http://nanto.asablo.jp/blog/2007/03/23/1339502\r
538         // Safari 2 では関数オブジェクトしか EventListener として使えませんが、Safari のナイトリービルドでは handleEvent メソッドを持つオブジェクトも EventListener として使えるようです。\r
539                 \r
540                 if( X_UA_EVENT.W3C ){\r
541                         switch( that[ '_rawType' ] ){\r
542                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
543                                         list.slcallback = X_Closure_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
544                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
545                                         break;\r
546                                 \r
547                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
548                                         if( X_UA[ 'Opera' ] < 12 ){\r
549                                                 // Opera11- の XHR は event オブジェクトが返らないため, eventType 毎に callback を指定する addEventListener もない\r
550                                                 raw[ 'on' + type ] = X_Closure_create( that, X_EventDispatcher_dispatch, [ type ] );\r
551                                                 break;\r
552                                         };\r
553 \r
554                                 default :\r
555                                         // iOS と MacOSX Iron36 で発生。連続してアニメーションが起こると、クロージャの束縛された obj へのアクセスに失敗する。Win では起きない?\r
556                                         // むしろ、MacOSX のブラウザ全般で起こる??\r
557                                         if( ( X_UA[ 'WebKit' ] || X_UA[ 'Blink' ] ) &&\r
558                                                 ( type === 'webkitTransitionEnd' || type === 'transitionend' ||\r
559                                                   type === 'animationend'        || type === 'webkitAnimationEnd' ||\r
560                                                   type === 'animationstart'      || type === 'webkitAnimationStart' ||\r
561                                                   type === 'animationiteration'  || type === 'webkitAnimationIteration' ) ){\r
562                                                 raw.addEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
563                                         } else {\r
564                                                 f = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Closure_create( that, X_EventDispatcher_actualHandleEvent ) );\r
565                 \r
566                                                 if( raw.addEventListener ){\r
567                                                         raw.addEventListener( type, f, false );\r
568                                                 } else {\r
569                                                         // Safari は Image, Opera7 は window\r
570                                                         raw[ 'on' + type ] = f;\r
571                                                 };\r
572                                         };\r
573                         };\r
574                 } else\r
575                 if( X_UA_EVENT.IE ){\r
576                         switch( that[ '_rawType' ] ){   \r
577                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
578                                         list.slcallback = X_Closure_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
579                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
580                                         break;                          \r
581                                 \r
582                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
583                                         console.log( 'XHR addEvent ' + type );\r
584                                         // ie8- の XHR は window.event が更新されないため, eventType 毎に callback を指定する\r
585                                         raw[ 'on' + type ] = X_Closure_create( that, X_EventDispatcher_dispatch, [ type ] );\r
586                                         break;\r
587                                 \r
588                                 default :\r
589                                         f = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Closure_create( that, X_EventDispatcher_actualHandleEvent ) );\r
590                                         \r
591                                         if( raw.attachEvent ){\r
592                                                 raw.attachEvent( 'on' + type, f );\r
593                                         } else {\r
594                                                 raw[ 'on' + type ] = f;\r
595                                         };\r
596                                         break;\r
597                         };\r
598                 } else {\r
599                         switch( that[ '_rawType' ] ){\r
600                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
601                                         // DOM0 で Silverlight ってあるの -> ie4 mobile?\r
602                                         list.slcallback = X_Closure_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
603                                         list.sltoken    = raw[ 'AddEventListener' ]( type, list.slcallback );\r
604                                         break;                          \r
605                                 \r
606                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
607                                         // ie4 mobile は XHR をサポート!\r
608                                         raw[ 'on' + type ] = X_Closure_create( that, X_EventDispatcher_dispatch, [ type ] );\r
609                                         break;\r
610 \r
611                                 default :\r
612                                         raw[ 'on' + type ] = that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] = X_Closure_create( that, X_EventDispatcher_actualHandleEvent ) );\r
613                                         break;\r
614                         };\r
615                 }\r
616         };\r
617 };\r
618 \r
619 \r
620 /*\r
621  * iOS の webkitTransitionEnd が連続して起こる場合、\r
622  * コールバックの(that[ X_LISTENERS_ACTUAL_HANDLER ])クロージャ内の実際のコールバック(X_Closure_actualClosure:obj._)が\r
623  * 参照できていない問題に遭遇、、、iOS3.1.3 & iOS6.1.5 で確認\r
624  * animation も怪しい、、、\r
625  */\r
626 function X_EventDispatcher_iOSTransitionEndDispatch( e ){\r
627         return X_Node_getXNode( this )[ 'dispatch' ]( X_Event_RenameTo[ e.type ] || e.type );\r
628 };\r
629 \r
630 /*\r
631  * Silverlight のイベントの概要\r
632  * http://msdn.microsoft.com/ja-jp/library/cc189018%28v=vs.95%29.aspx#the_sender_parameter_and_event_data\r
633  */\r
634 function X_EventDispatcher_sliverLightDispatch( sender, e, type ){\r
635         return this[ 'dispatch' ]( type );\r
636 };\r
637 \r
638 function X_EventDispatcher_actualRemoveEvent( that, type, raw, list, skip ){\r
639         var i;\r
640         X_EventDispatcher_unlock || ( type = X_Event_Rename[ type ] || type );\r
641         \r
642         if( X_Type_isArray( type ) ){\r
643                 for( i = type.length; i; ){\r
644                         X_EventDispatcher_systemUnlisten( that, type[ --i ], X_emptyFunction );\r
645                 };\r
646         } else {\r
647                 if( X_UA_EVENT.W3C ){\r
648                         switch( that[ '_rawType' ] ){\r
649                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
650                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
651                                         X_Closure_correct( list.slcallback );\r
652                                         delete list.sltoken;\r
653                                         delete list.slcallback;\r
654                                         break;\r
655                                 \r
656                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
657                                         if( X_UA[ 'Opera' ] < 12 ){\r
658                                                 // Opera11- の XHR は event オブジェクトが返らないため, eventType 毎に callback を指定する addEventListener もない\r
659                                                 X_Closure_correct( raw[ 'on' + type ] );\r
660                                                 raw[ 'on' + type ] = '';\r
661                                                 break;\r
662                                         };\r
663 \r
664                                 default :\r
665                                         if( ( X_UA[ 'WebKit' ] || X_UA[ 'Blink' ] ) &&\r
666                                                 ( type === 'webkitTransitionEnd' || type === 'transitionend' ||\r
667                                                   type === 'animationend'        || type === 'webkitAnimationEnd' ||\r
668                                                   type === 'animationstart'      || type === 'webkitAnimationStart' ||\r
669                                                   type === 'animationiteration'  || type === 'webkitAnimationIteration' ) ){\r
670                                                 raw.removeEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
671                                         } else                  \r
672                                         if( raw.addEventListener ){\r
673                                                 raw.removeEventListener( type, that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ], false );\r
674                                         } else {\r
675                                                 raw[ 'on' + type ] = null;\r
676                                         };\r
677                                         \r
678                                         if( !skip && that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] ){\r
679                                                 X_Closure_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
680                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
681                                         };\r
682                         };\r
683                 } else\r
684                 if( X_UA_EVENT.IE ){\r
685                         switch( that[ '_rawType' ] ){\r
686                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
687                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
688                                         X_Closure_correct( list.slcallback );\r
689                                         delete list.sltoken;\r
690                                         delete list.slcallback;\r
691                                         break;\r
692                                 \r
693                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
694                                         X_Closure_correct( raw[ 'on' + type ] );\r
695                                         raw[ 'on' + type ] = X_emptyFunction;\r
696                                         raw[ 'on' + type ] = '';\r
697                                         console.log( 'XHR rmEvent ' + type );\r
698                                         break;\r
699 \r
700                                 default :\r
701                                         if( raw.attachEvent ){\r
702                                                 raw.detachEvent( 'on' + type, that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
703                                                 console.log( 'raw rmEvent ' + type );\r
704                                         } else {\r
705                                                 raw[ 'on' + type ] = X_emptyFunction;\r
706                                                 raw[ 'on' + type ] = '';\r
707                                         };\r
708                                         \r
709                                         if( !skip ){\r
710                                                 X_Closure_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
711                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
712                                         };\r
713                         };\r
714                 } else {\r
715                         switch( that[ '_rawType' ] ){\r
716                                 case X_EventDispatcher_EVENT_TARGET_SILVER_LIGHT :\r
717                                         raw[ 'RemoveEventListener' ]( type, list.sltoken ); // token\r
718                                         X_Closure_correct( list.slcallback );\r
719                                         delete list.sltoken;\r
720                                         delete list.slcallback;\r
721                                         break;\r
722                                 \r
723                                 case X_EventDispatcher_EVENT_TARGET_XHR :\r
724                                         X_Closure_correct( raw[ 'on' + type ] );\r
725                                         raw[ 'on' + type ] = X_emptyFunction;\r
726                                         raw[ 'on' + type ] = '';\r
727                                         break;\r
728 \r
729                                 default :\r
730                                         raw[ 'on' + type ] = X_emptyFunction;\r
731                                         raw[ 'on' + type ] = '';\r
732                                         \r
733                                         if( !skip ){\r
734                                                 X_Closure_correct( that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ] );\r
735                                                 delete that[ '_listeners' ][ X_LISTENERS_ACTUAL_HANDLER ];\r
736                                         };\r
737                         };\r
738                 };\r
739         };\r
740 };\r
741 \r
742 \r
743 // TODO ブラウザからの呼び出しの最後に登録された関数を呼び出す機能(例えば画面の更新)\r
744 \r
745 // handleEvent を拡張可能にするために、クロージャに移動した\r
746 // Is this in regard to the Safari 1.x preventDefault bug on click/dblclick?\r
747 // https://groups.google.com/forum/#!msg/comp.lang.javascript/uYEuCHjHxnw/yKoHtZJPa1QJ\r
748 var X_EventDispatcher_actualHandleEvent =\r
749         X_UA_EVENT.IE4 || X_UA_EVENT.IE ? // ie45678 EVENT_IE & EVENT_DOM0 for ie4\r
750                 (function(){\r
751                         var e = event, ret;\r
752                         \r
753                         ret = this[ 'dispatch' ]( new X_DomEvent( e, this, this[ '_rawObject' ] ) );\r
754 \r
755                         if( ret & X_CALLBACK_STOP_PROPAGATION ){\r
756                                 e.cancelBubble = true;\r
757                         };\r
758                         if( ret & X_CALLBACK_PREVENT_DEFAULT ){\r
759                                 this[ '_tag' ] === 'A' && this[ '_rawObject' ].blur();\r
760                                 return e.returnValue = false;\r
761                         };\r
762                 }) :\r
763         //X_UA_EVENT.W3C || X_UA_EVENT.DOM0\r
764                 (function( e ){\r
765                         var ev  = new X_DomEvent( e, this ),\r
766                                 ret = X_CALLBACK_NONE,\r
767                                 i, l;\r
768                         //console.log( '>>>>>>>>>> ' + e.type );\r
769                         // touch event -> pointer\r
770                         if( X_Type_isArray( ev ) ){\r
771                                 if( ev.length === 0 ){\r
772                                         // TouchEvent の後に発生した MouseEvent のキャンセル\r
773                                         ret = X_CALLBACK_STOP_PROPAGATION | X_CALLBACK_PREVENT_DEFAULT;\r
774                                 } else {\r
775                                         for( i = 0, l = ev.length; i < l; ++i ){\r
776                                                 //console.log( 'handleEvent ' + ev[ i ].type );\r
777                                                 ret |= this[ 'dispatch' ]( ev[ i ] ) || 0;\r
778                                         };\r
779                                 };\r
780                         } else {\r
781                                 ret = this[ 'dispatch' ]( ev );\r
782                         };\r
783                         \r
784                         if( ret & X_CALLBACK_STOP_PROPAGATION ){\r
785                                 e.stopPropagation();\r
786                         };\r
787                         if( ret & X_CALLBACK_PREVENT_DEFAULT ){\r
788                                 this[ '_tag' ] === 'A' && this[ '_rawObject' ].blur();\r
789                                 e.preventDefault();\r
790                                 if( X_UA[ 'WebKit' ] < 525.13 ){ // Safari3-\r
791                                         if( e.type === 'click' || e.type === 'dbclick' ){\r
792                                                 X_EventDispatcher_safariPreventDefault = true;\r
793                                         };\r
794                                 };\r
795                                 return false;\r
796                         };\r
797                 });\r
798 \r
799 if( X_UA[ 'WebKit' ] < 525.13 ){ // Safari3-\r
800         document.documentElement.onclick =\r
801         document.documentElement[ 'ondbclick' ] = function( e ){\r
802                         if( X_EventDispatcher_safariPreventDefault ){\r
803                                 X_EventDispatcher_safariPreventDefault = false;\r
804                                 e.preventDefault();\r
805                                 return false;\r
806                         };\r
807                 };\r
808 };\r
809 \r
810 // イベントの退避、dom が画面から抜かれる場合に実施しておく\r
811 // 退避したイベントの復帰\r
812 function X_EventDispatcher_toggleAllEvents( that, add ){\r
813         var list = that[ '_listeners' ],\r
814                 raw  = that[ '_rawObject' ] || X_UA_DOM.IE4 && X_Node__ie4getRawNode( that ),\r
815                 func = add ? X_EventDispatcher_actualAddEvent : X_EventDispatcher_actualRemoveEvent,\r
816                 type;\r
817         if( !list || !raw ) return;\r
818         for( type in list ){\r
819                 //if( X_EMPTY_OBJECT[ type ] ) continue;\r
820                 // 数字イベントの除外\r
821                 if( !X_String_isNumberString( type ) ){\r
822                         // TODO type rename はここ\r
823                         func( that, type, raw, list[ type ], true );\r
824                 };\r
825         };\r
826 };\r
827 \r
828 \r
829 console.log( 'X.Core.EventDispatcher' );\r