OSDN Git Service

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