OSDN Git Service

Version 0.6.107, cleanup X.NodeCSS, fix X.Node.Event for touch, add unescape for...
[pettanr/clientJs.git] / 0.6.x / js / 01_core / 13_XEventDispatcher.js
index bd69138..1aaadc5 100644 (file)
@@ -1,4 +1,8 @@
 /**\r
+ * \r
+ */\r
+\r
+/**\r
  * X.EventDispatcher\r
  * \r
  *  1. as3 の EventDispatcher ライクなクラス。そのまま使ったり、継承したり。コールバック中にイベントを追加したら?削除したら?にも対処している。\r
@@ -32,31 +36,34 @@ var X_EventDispatcher_once       = false,
 // ------------------------------------------------------------------------- //\r
 \r
 /**\r
- * イベントターゲット(widnow, document, Image, XHR, Silverlight 等)をラップする場合、通常は new 時に渡します。参照:コンストラクタ実体 {@link X.EventDispatcher.Constructor}\r
- * アプリケーション独自のイベントをやり取りしたいだけ、という場合、イベントターゲットは不要です。\r
+ * <p>イベントターゲット(widnow, document, Image, XHR, Silverlight 等)をラップする場合、通常は new 時に渡します。\r
+ * <p>参照:コンストラクタ実体 {@link X.EventDispatcher.Constructor}\r
+ * <p>アプリケーション独自のイベントをやり取りしたい、という場合、イベントターゲットは不要です。\r
+ * \r
  * @class\r
  * @classdesc EventTarget オブジェクトをラップしたり、アプリケーションで独自に定義したイベントを発信するためのクラスです。\r
- *     listen, unlisten, dispatch という addEventListener, removeEventListener, dispatchEvent に対応する関数を持ちます。\r
- *     さらに listening という as3 の hasEventListener に相当する関数を持ちます。\r
- *     イベントターゲットオブジェクト(widnow, document, HTMLElement, XHR 等)が _rawObject に設定されていた場合に、それらへ実際のイベント登録・解除も行います。\r
- *     このイベントの登録・解除はクロスブラウザで、IE5~8 の独自イベントの差異を吸収し、DOM0 に対しても複数のコールバックを登録することができます。\r
- *     またコールバックに対して、this コンテキストや、追加の引数を指定もできます。 this コンテキストを指定しなかった場合、EventDispatcher インスタンスがコールバックの this になります。 \r
- *     unlisten() は、引数を指定しなかった場合、全てのイベントを解除します。ただし、systemListen 経由で登録されたハンドラは解除されません。\r
+ *     <p>listen, unlisten, dispatch という addEventListener, removeEventListener, dispatchEvent に対応する関数を持ちます。\r
+ *     <p>また listening という ActionScript3 の hasEventListener に相当する関数を持ちます。\r
+ *     <p>イベントターゲットオブジェクト(widnow, document, HTMLElement, XHR 等)が this._rawObject に設定されていた場合に、それらへ実際のイベント登録・解除も行います。\r
+ *     <p>このイベントの登録・解除はクロスブラウザで、IE5~8 の独自イベントの差異を吸収し、DOM0 に対しても複数のコールバックを登録することができます。\r
+ *     <p>またコールバックに対して、this コンテキストや、追加の引数を指定もできます。 this コンテキストを指定しなかった場合、EventDispatcher インスタンスがコールバックの this になります。 \r
+ *     <p>unlisten() は、引数を指定しなかった場合、全てのイベントを解除します。ただし、systemListen 経由で登録されたハンドラは解除されません。\r
  *     systemListen, systemUnlisten は、ライブラリ内のコードからしかアクセスできません。\r
- * @param {object=} opt_rawObject\r
+ * \r
+ * @augments X_Class_CommonProps\r
+ * \r
+ * @param {object=} opt_rawObject イベントターゲット(EventTarget)\r
  */\r
 X.EventDispatcher =\r
        X.Class.create(\r
                'EventDispatcher',\r
                \r
-       /** @lends {X.EventDispatcher.prototype} */\r
+           /** @lends X.EventDispatcher.prototype */\r
                {\r
 \r
-           /**\r
-            * @namespace\r
-            * @memberof X.EventDispatcher\r
-            */\r
 \r
+\r
+               // TODO _rawObjectType EventTarget, XHR, Silverlight, ...\r
                /**\r
                 * イベントリスナをイベント名(string)や数値(1~,フレームワーク内で定義)をキーとするArrayで記憶します。\r
                 * Arrayには、{k:種類,x:コンテキスト(thisObject),f:関数,s:サプリメントする引数の配列} というハッシュ、または関数が蓄えられています。\r
@@ -83,7 +90,7 @@ X.EventDispatcher =
                 */\r
                        '_handleEvent'  : null,\r
                        \r
-               /*\r
+               /**\r
                 * dispatch 中に dispatch が呼ばれた際に、そのネストの深さを保存する。\r
                 * dispatch() 終了時に _dispatching が 0 の場合に、現在のインスタンスの dispatch がすべて終わったことになる。\r
                 * @private\r
@@ -91,7 +98,7 @@ X.EventDispatcher =
                 */\r
                        '_dispatching'  : 0,     // dispatch 中の unlisten で使用\r
 \r
-               /*\r
+               /**\r
                 * dispatch 中に listen が呼ばれた場合に、配列のindexがずれることを避けるため、一旦保持する。\r
                 * _dispatching が 0 のときに _reserves を使って listen() を呼び出す。\r
                 * @private\r
@@ -99,7 +106,7 @@ X.EventDispatcher =
                 */\r
                        '_reserves'     : null,\r
                \r
-               /*\r
+               /**\r
                 * dispatch 中に unlisten が呼ばれた場合に、配列のindexがずれることを避けるため、一旦保持する。\r
                 * _dispatching が 0 のときに _unlistens を使って unlisten() を呼び出す。\r
                 * @private\r
@@ -107,7 +114,7 @@ X.EventDispatcher =
                 */\r
                        '_unlistens'    : null,\r
                        \r
-               /*\r
+               /**\r
                 * dispatch 中に kill が呼ばれた場合に、X.EventDispatcher インスタンスの削除を dispatch 後にずらすために立てるフラグ。\r
                 * @private\r
                 * @type {boolean}\r
@@ -116,9 +123,9 @@ X.EventDispatcher =
                        \r
            /**\r
             * X.EventDispatcher のコンストラクタの実体。\r
-            * @constructs\r
+            * @@@constructs\r
             * @this {X.EventDispatcher}\r
-            * @params {object=} opt_rawObject\r
+            * @param {object=} opt_rawObject\r
             */\r
                        Constructor : function( opt_rawObject ){\r
                                if( opt_rawObject ){\r
@@ -134,11 +141,20 @@ X.EventDispatcher =
                 */     \r
                        dispatch : X_EventDispatcher_dispatch,\r
 \r
-           /**\r
-            * \r
-            * @this {X.EventDispatcher}\r
-            */\r
+               /**\r
+                * @function\r
+                */\r
                        on     : X_EventDispatcher_listen,\r
+                       \r
+               /**\r
+                * \r
+                * @this {X.EventDispatcher}\r
+                * @param {(string|number|Array.<(string,number)>)} type\r
+                * @param {(listener|function|Array)=} opt_arg1\r
+                * @param {(function|Array=} opt_arg2\r
+                * @param {Array=} opt_arg3\r
+                * @return {X.EventDispatcher}\r
+                */\r
                        listen : X_EventDispatcher_listen,\r
                \r
                /**\r
@@ -161,12 +177,15 @@ X.EventDispatcher =
                        unlisten : X_EventDispatcher_unlisten,\r
 \r
                /**\r
-                * イベントリスナの登録状況を真偽値で返す。戻り値が数値(index)の場合もあるが、これは内部のみで使用。\r
-                * listening() と type を省略した場合、一つでも登録があれば true を返す。\r
-                * listening( type ) と type だけを与えた場合、その type に登録があれば true を返す。\r
-                * type と イベントリスナの組み合わせが登録されているかを調べる場合は、listen 時の thisObject や args(Array) も一致させて渡す必要がある。\r
+                * <p>イベントリスナの登録状況を真偽値で返す。戻り値が数値(index)の場合もあるが、これは内部のみで使用。\r
+                * <p>this.listening(); のように type を省略した場合、一つでも登録があれば true を返す。\r
+                * <p>this.listening( 'myevent' ); と type だけを与えた場合、その type に登録があれば true を返す。\r
+                * <p>type と イベントリスナの組み合わせが登録されているかを調べる場合は、listen 時の thisObject や args(Array) も一致させて渡す必要がある。\r
+                * \r
+                * @example \r
                 *  this.listen( [ 'myevent', 'yourevent' ], this, onMyEvent, args = [ 1, 'a' ] );\r
                 *  this.listening( 'myevent', this, onMyEvent, args ) === true;\r
+                * \r
                 * @this {X.EventDispatcher}\r
                 * @return {(number|boolean)}\r
                 * @param {(string|number)=} opt_type\r
@@ -207,15 +226,14 @@ X.EventDispatcher =
                /**\r
                 * delay(ミリ秒)後にイベントを dispatch する。戻り値は uid = X.Timer.add() のタイマーID(数値)。X.Timer.remove(uid) でタイマーを解除して dispatch を中止できる。\r
                 * @this {X.EventDispatcher}\r
-                * @return {number}\r
-                * @param {number=} delay ms 省略した場合は 0 として扱う asyncDispatch( 'myevent' ) -> asyncDispatch( 0, 'myevent' )\r
-                * @param {(eventHash|string|number)=} e\r
+                * @param {(number|eventHash|string)=} delay ms 省略した場合は 0 として扱う asyncDispatch( 'myevent' ) -> asyncDispatch( 0, 'myevent' )\r
+                * @param {(eventHash|string|number)=} e イベントを表す数値、文字列、{ type : XXX, ... } なオブジェクト\r
+                * @return {number} X.Timer.add() の戻り値\r
                 */                     \r
                        asyncDispatch : function( delay, e ){\r
                                if( delay && e === undefined ){\r
                                        e = delay;\r
                                        delay = 0;\r
-                                       console.log( 'lazy : ' + e );\r
                                };\r
                                return X.Timer.add( delay, 1, this, this.dispatch, [ e ] );\r
                        }\r
@@ -325,15 +343,18 @@ function X_EventDispatcher_dispatch( e ){
 /**\r
  * \r
  * @this {X.EventDispatcher}\r
- * @return {X.EventDispatcher}\r
+ * @memberOf X.EventDispatcher.prototype\r
  * @param {(string|number|Array.<(string,number)>)} type\r
  * @param {(listener|function|Array)=} opt_arg1\r
  * @param {(function|Array=} opt_arg2\r
  * @param {Array=} opt_arg3\r
+ * @return {X.EventDispatcher}\r
  */\r
 function X_EventDispatcher_listen( type, opt_arg1, opt_arg2, opt_arg3 ){\r
        var list = this._listeners,\r
                i, raw, add, f;\r
+\r
+       if( !type ) return this;\r
        \r
        if( this._dispatching ){\r
                if( !this._reserves ) this._reserves = [];\r
@@ -351,7 +372,7 @@ function X_EventDispatcher_listen( type, opt_arg1, opt_arg2, opt_arg3 ){
        raw = this._rawObject || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
        add = raw && ( !list || !list[ type ] ) && X.Type.isString( type );\r
        \r
-       if( this.listening( type, opt_arg1, opt_arg2, opt_arg3 ) ) return this;\r
+       if( this.listening( type, opt_arg1 || this, opt_arg2, opt_arg3 ) ) return this;\r
 \r
        if( !list ) list = this._listeners = {};\r
        if( !( list = list[ type ] ) ) list = this._listeners[ type ] = [];\r
@@ -375,6 +396,8 @@ function X_EventDispatcher_systemListen( that, type, opt_arg1, opt_arg2, opt_arg
        X_EventDispatcher_lock = false;\r
 };\r
 \r
+// TODO this.listen(type) は this リスナの登録なのに、this.unlisten(type)は全てのtypeの削除、と不一致\r
+\r
 /**\r
  * \r
  * @this {X.EventDispatcher}\r
@@ -472,7 +495,7 @@ function X_EventDispatcher_addEvent( that, type, raw, list ){
        if( X.Type.isArray( type ) ){\r
                for( i = type.length; i; ){\r
                        X_EventDispatcher_systemListen( that, type[ --i ], X.emptyFunction );\r
-                       console.log( 'X_EventDispatcher_systemListen ' + type[ i ] );\r
+                       console.log( 'events fix > ' + type[ i ] );\r
                };\r
        } else {\r
                X_EventDispatcher_actualAddEvent( that, type, raw, list );\r
@@ -483,18 +506,22 @@ var X_EventDispatcher_actualAddEvent =
        // Days on the Moon DOM Events とブラウザの実装 \r
        // http://nanto.asablo.jp/blog/2007/03/23/1339502\r
        // Safari 2 では関数オブジェクトしか EventListener として使えませんが、Safari のナイトリービルドでは handleEvent メソッドを持つオブジェクトも EventListener として使えるようです。\r
-       X_UA_EVENT.W3C /* && ( X.UA.WebKit < 525.13 || X.UA.Opera7 || X.UA.NetFront < 4 ) */ ? // Safari3-\r
+       X_UA_EVENT.W3C /* && ( X_UA.WebKit < 525.13 || X_UA.Opera7 || X_UA.NetFront < 4 ) */ ? // Safari3-\r
                (function( that, type, raw, list ){\r
-                       if( that._isXHR && X.UA.Opera < 12 ){\r
+                       if( that._isXHR && X_UA.Opera < 12 ){\r
                                // Opera11- の XHR は event オブジェクトが返らないため, eventType 毎に callback を指定する addEventListener もない\r
                                raw[ 'on' + type ] = X_Callback_create( that, X_EventDispatcher_dispatch, [ type ] );\r
                        } else\r
                        if( that._isSilverlight ){\r
                                list.slcallback = X_Callback_create( that, X_EventDispatcher_sliverLightDispatch, [ type ] );\r
                                list.sltoken    = raw.AddEventListener( type, list.slcallback );\r
-                       } else {                \r
+                       } else {\r
+                               console.log( 'event > ' + type );\r
                                that._handleEvent || ( that._handleEvent = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
-\r
+                               \r
+                               if( X.UA.iOS && type === 'webkitTransitionEnd' ){\r
+                                       raw.addEventListener( type, X_EventDispatcher_iOS3transitionEndDispatch, false );\r
+                               } else\r
                                if( raw.addEventListener ){\r
                                        raw.addEventListener( type, that._handleEvent, false );\r
                                } else {\r
@@ -537,6 +564,16 @@ var X_EventDispatcher_actualAddEvent =
                });\r
 \r
 /*\r
+ * iOS の webkitTransitionEnd が連続して起こる場合、\r
+ * コールバックの(that._handleEvent)クロージャ内の実際のコールバック(X_Callback_actualClosure:obj._)が\r
+ * 参照できていない問題に遭遇、、、iOS3.1.3 & iOS6.1.5 で確認\r
+ * animation も怪しい、、、\r
+ */\r
+function X_EventDispatcher_iOS3transitionEndDispatch( e ){\r
+       return X_Node_getXNode( this ).dispatch( X_Event_RenameTo[ e.type ] );\r
+};\r
+\r
+/*\r
  * Silverlight のイベントの概要\r
  * http://msdn.microsoft.com/ja-jp/library/cc189018%28v=vs.95%29.aspx#the_sender_parameter_and_event_data\r
  */\r
@@ -558,9 +595,9 @@ function X_EventDispatcher_removeEvent( that, type, raw, list, skip ){
 };\r
 \r
 var X_EventDispatcher_actualRemoveEvent =\r
-       X_UA_EVENT.W3C /*&& ( X.UA.WebKit < 525.13 || X.UA.Opera7 || X.UA.NetFront < 4 )*/ ? // Safari3-\r
+       X_UA_EVENT.W3C /*&& ( X_UA.WebKit < 525.13 || X_UA.Opera7 || X_UA.NetFront < 4 )*/ ? // Safari3-\r
                (function( that, type, raw, list, skip ){\r
-                       if( that._isXHR && X.UA.Opera < 12 ){\r
+                       if( that._isXHR && X_UA.Opera < 12 ){\r
                                X_Callback_correct( raw[ 'on' + type ] );\r
                                raw[ 'on' + type ] = '';\r
                        } else  \r
@@ -570,6 +607,9 @@ var X_EventDispatcher_actualRemoveEvent =
                                delete list.sltoken;\r
                                delete list.slcallback;\r
                        } else {\r
+                               if( X.UA.iOS && type === 'webkitTransitionEnd' ){\r
+                                       raw.removeEventListener( type, X_EventDispatcher_iOS3transitionEndDispatch, false );\r
+                               } else                          \r
                                if( raw.addEventListener ){\r
                                        raw.removeEventListener( type, that._handleEvent, false );\r
                                } else {\r
@@ -657,7 +697,7 @@ var X_EventDispatcher_actualHandleEvent =
                        var ev  = new X.Dom.Event( e, this ),\r
                                ret = X_Callback_NONE,\r
                                i, l;\r
-                       console.log( '>>>>>>>>>> ' + e.type );\r
+                       //console.log( '>>>>>>>>>> ' + e.type );\r
                        // touch event -> pointer\r
                        if( X.Type.isArray( ev ) ){\r
                                if( ev.length === 0 ){\r
@@ -679,7 +719,7 @@ var X_EventDispatcher_actualHandleEvent =
                        if( ret & X.Callback.PREVENT_DEFAULT ){\r
                                this._tag === 'A' && this._rawObject.blur();\r
                                e.preventDefault();\r
-                               if( X.UA.WebKit < 525.13 ){ // Safari3-\r
+                               if( X_UA.WebKit < 525.13 ){ // Safari3-\r
                                        if( e.type === 'click' || e.type === 'dbclick' ){\r
                                                X_EventDispatcher_safariPreventDefault = true;\r
                                        };\r
@@ -688,7 +728,7 @@ var X_EventDispatcher_actualHandleEvent =
                        };\r
                });\r
 \r
-if( X.UA.WebKit < 525.13 ){ // Safari3-\r
+if( X_UA.WebKit < 525.13 ){ // Safari3-\r
        document.documentElement.onclick =\r
        document.documentElement.ondbclick = function( e ){\r
                        if( X_EventDispatcher_safariPreventDefault ){\r