OSDN Git Service

Version 0.6.134, add comments for closure compiler.
[pettanr/clientJs.git] / 0.6.x / js / 01_core / 10_XCallback.js
index 189ba59..964b2ca 100644 (file)
@@ -3,21 +3,35 @@
 // ------------ local variables -------------------------------------------- //\r
 // ------------------------------------------------------------------------- //\r
 \r
-var X_Callback_LIVE_LIST        = [],\r
+var /** @const */\r
+       X_Callback_LIVE_LIST        = [],\r
+       /** @const */\r
        X_Callback_POOL_LIST        = [],\r
+       /** @const */\r
        X_Closure_COMMAND_BACK      = X_Callback_LIVE_LIST,\r
+       /** @const */\r
        X_Closure_COMMAND_DROP      = X_Callback_POOL_LIST,\r
        \r
+       /** @const */\r
        X_Callback_THIS_FUNC        = 1,\r
+       /** @const */\r
        X_Callback_HANDLEEVENT      = 2,\r
+       /** @const */\r
        X_Callback_FUNC_ONLY        = 3,\r
 \r
+       /** @const */\r
        X_Callback_NONE             =  0,\r
+       /** @const */\r
        X_Callback_UN_LISTEN        =  1,\r
-       X_Callback_STOP_PROPAGATION =  2,  // 上位階層への伝播のキャンセル\r
+       /** @const */\r
+       X_Callback_STOP_PROPAGATION =  2,\r
+       /** @const */\r
        X_Callback_STOP_NOW         =  4 | 2,  // 同一階層のリスナーのキャンセル(上位へもキャンセル)\r
+       /** @const */\r
        X_Callback_PREVENT_DEFAULT  =  8,  // 結果動作のキャンセル,\r
+       /** @const */\r
        X_Callback_MONOPOLY         = 16,  // move event を独占する\r
+       /** @const */\r
        X_Callback_SYS_CANCEL       = 32 | 4 | 2;\r
 \r
 /*\r
@@ -116,28 +130,28 @@ X.Callback = {
        /**\r
         * このコールバックでは返り値による操作は無い。\r
         */\r
-       NONE             : X_Callback_NONE,\r
+       'NONE'             : X_Callback_NONE,\r
        /**\r
-        * X.Timer.add, X.EventDispatcher.listen のコールバックでタイマーやイベントリスナの解除に使用。\r
+        * X.Timer, X.EventDispatcher のコールバックでタイマーやイベントリスナの解除に使用。\r
         */\r
-       UN_LISTEN        : X_Callback_UN_LISTEN,\r
+       'UN_LISTEN'        : X_Callback_UN_LISTEN,\r
        /**\r
-        * イベントのバブルアップを中止する。DOM イベントのコールバックの戻り値に指定すると e.stopPropagation() が呼ばれる。\r
+        * 上位階層へのイベント伝播のキャンセル。DOM イベントのコールバックの戻り値に指定すると e.stopPropagation() が呼ばれる。\r
         */\r
-       STOP_PROPAGATION : X_Callback_STOP_PROPAGATION,\r
+       'STOP_PROPAGATION' : X_Callback_STOP_PROPAGATION,\r
        /**\r
-        * 以降のイベントのディスパッチを中断する。\r
+        * 以降のイベントのディスパッチを中断する。STOP_PROPAGATION との違いは、次に控えているコールバックもキャンセルされる点。但し system によって追加されたイベントはキャンセルされない。\r
         */\r
-       STOP_NOW         : X_Callback_STOP_NOW,\r
+       'STOP_NOW'         : X_Callback_STOP_NOW,\r
        /**\r
         * DOM イベントのコールバックの戻り値に指定すると e.preventDefault() が呼ばれる。\r
         * またフレームワーク内で定義されたデフォルト動作の回避にも使用される。\r
         */\r
-       PREVENT_DEFAULT  : X_Callback_PREVENT_DEFAULT,\r
+       'PREVENT_DEFAULT'  : X_Callback_PREVENT_DEFAULT,\r
        /**\r
         * X.UI に於いて、ポインターイベントの戻り値に指定すると、以降のポインターベントを独占する。\r
         */\r
-       MONOPOLY         : X_Callback_MONOPOLY\r
+       'MONOPOLY'         : X_Callback_MONOPOLY\r
 };\r
 \r
 // ------------------------------------------------------------------------- //\r
@@ -147,18 +161,21 @@ X.Callback = {
 function X_Callback_create( thisObject, opt_callback, opt_args /* [ listener || ( context + function ) || function ][ args... ] */ ){\r
        var obj = X_Callback_classifyCallbackArgs( thisObject, opt_callback, opt_args ),\r
                l, ret, _obj;\r
-       if( !obj.k ) return obj;\r
+       \r
+       if( !obj.kind ) return obj;\r
+       \r
        if( l = X_Callback_POOL_LIST.length ){\r
-               ret    = X_Callback_POOL_LIST[ l - 1 ]; --X_Callback_POOL_LIST.length; // ret = X_Callback_POOL_LIST.pop();\r
-               _obj   = ret( X_Closure_COMMAND_BACK );\r
-               _obj.k = obj.k;\r
-               _obj.f = obj.f;\r
-               _obj.x = obj.x;\r
-               _obj.s = obj.s;\r
-               _obj._ = X_Callback_proxyCallback;\r
+               ret  = X_Callback_POOL_LIST[ l - 1 ]; --X_Callback_POOL_LIST.length; // ret = X_Callback_POOL_LIST.pop();\r
+               _obj = ret( X_Closure_COMMAND_BACK );\r
+               \r
+               _obj.kind       = obj.kind;\r
+               _obj.func       = obj.func;\r
+               _obj.context    = obj.context;\r
+               _obj.supplement = obj.supplement;\r
+               _obj.proxy      = X_Callback_proxyCallback;\r
        } else {\r
-               ret = X_Callback_actualClosure( obj );\r
-               obj._ = X_Callback_proxyCallback;\r
+               ret             = X_Callback_actualClosure( obj );\r
+               obj.proxy       = X_Callback_proxyCallback;\r
        };\r
        X_Callback_LIVE_LIST[ X_Callback_LIVE_LIST.length ] = ret;\r
        return ret;\r
@@ -169,30 +186,30 @@ function X_Callback_classifyCallbackArgs( arg1, arg2, arg3, alt_context ){
        var obj;\r
        \r
        if( arg1 && X_Type_isFunction( arg2 ) ){\r
-               obj  = { x : arg1, f : arg2, k : X_Callback_THIS_FUNC };\r
+               obj  = { context : arg1, func : arg2, kind : X_Callback_THIS_FUNC };\r
        } else\r
        if( arg1 && X_Type_isFunction( arg1[ 'handleEvent' ] ) ){\r
-               obj  = { x : arg1, k : X_Callback_HANDLEEVENT };\r
+               obj  = { context : arg1, kind : X_Callback_HANDLEEVENT };\r
                arg3 = arg2;\r
        } else\r
        if( X_Type_isFunction( arg1 ) ){\r
                arg3 = arg2;\r
                if( alt_context ){\r
-                       obj  = { x : alt_context, f : arg1, k : X_Callback_THIS_FUNC };\r
+                       obj  = { context : alt_context, func : arg1, kind : X_Callback_THIS_FUNC };\r
                } else {\r
-                       obj  = { f : arg1, k : X_Callback_FUNC_ONLY };\r
+                       obj  = { func : arg1, kind : X_Callback_FUNC_ONLY };\r
                };\r
        } else\r
        if( X_Type_isFunction( arg2 ) ){\r
                //console.log( 'X_Callback_classifyCallbackArgs : arg1 が ' + arg1 + 'です' ); ie4 で error\r
                if( alt_context ){\r
-                       obj  = { x : alt_context, f : arg2, k : X_Callback_THIS_FUNC };\r
+                       obj  = { context : alt_context, func : arg2, kind : X_Callback_THIS_FUNC };\r
                } else {\r
-                       obj  = { f : arg2, k : X_Callback_FUNC_ONLY };\r
+                       obj  = { func : arg2, kind : X_Callback_FUNC_ONLY };\r
                };\r
        } else\r
        if( alt_context ){\r
-               obj  = { x : alt_context, k : X_Callback_HANDLEEVENT };\r
+               obj  = { context : alt_context, kind : X_Callback_HANDLEEVENT };\r
                arg3 = arg1;\r
        } else {\r
                console.log( '不正 ' + arg1 );\r
@@ -201,23 +218,23 @@ function X_Callback_classifyCallbackArgs( arg1, arg2, arg3, alt_context ){
        };\r
        \r
        if( X_Type_isArray( arg3 )){\r
-               obj.s = arg3;\r
+               obj.supplement = arg3;\r
        };\r
-       return ( obj.x || obj.s ) ? obj : arg1;\r
+       return ( obj.context || obj.supplement ) ? obj : arg1;\r
 };\r
 \r
 function X_Callback_actualClosure( obj ){\r
        return function(){\r
                if( arguments[ 0 ] === X_Closure_COMMAND_BACK ) return obj;\r
-               if( arguments[ 0 ] !== X_Closure_COMMAND_DROP ) return obj._( obj, arguments );\r
+               if( arguments[ 0 ] !== X_Closure_COMMAND_DROP ) return obj.proxy( obj, arguments );\r
        };\r
 };\r
 \r
 function X_Callback_proxyCallback( xfunc, _args ){\r
        var args    = _args || [],\r
-               thisObj = xfunc.x,\r
-               func    = xfunc.f,\r
-               supp    = xfunc.s,\r
+               thisObj = xfunc.context,\r
+               func    = xfunc.func,\r
+               supp    = xfunc.supplement,\r
                temp, ret;      \r
        \r
        if( supp && supp.length ){\r
@@ -234,7 +251,7 @@ function X_Callback_proxyCallback( xfunc, _args ){
                args = temp;\r
        };\r
        \r
-       switch( xfunc.k ){\r
+       switch( xfunc.kind ){\r
 \r
                case X_Callback_THIS_FUNC :\r
                        return args.length === 0 ? func.call( thisObj ) : func.apply( thisObj, args );\r
@@ -272,11 +289,11 @@ function X_Callback_correct( f ){
                X_Callback_LIVE_LIST.splice( i, 1 );\r
                X_Callback_POOL_LIST[ X_Callback_POOL_LIST.length ] = f;\r
                obj = f( X_Closure_COMMAND_BACK );\r
-               delete obj.k;\r
-               if( obj.f ) delete obj.f;\r
-               if( obj.x ) delete obj.x;\r
-               if( obj.s ) delete obj.s;\r
-               delete obj._;\r
+               delete obj.kind;\r
+               if( obj.func ) delete obj.func;\r
+               if( obj.context ) delete obj.context;\r
+               if( obj.supplement ) delete obj.supplement;\r
+               delete obj.proxy;\r
                return true;\r
        };\r
        return false;\r