+/**\r
+ * <h4>はじめに:Web 開発の世界へようこそ!</h4>\r
+ * DHTML と XHR 等を活用した Ajax によってその真価を発揮した javascript は、現在では RIA に SPA や 3D ゲームなど、あらゆるアプリケーションがブラウザ上で動きつつあります。\r
+ * それらの素晴らしいデモに触れ、これから Web 開発に望む皆さんは、胸をときめかせていることでしょう。\r
+ * そうです、今や Web ブラウザは、あなたの夢を何でも描くことの出来る自由なフロンティアです。\r
+ * \r
+ * しかし、いざ Javascript を触り始め、初めての開発に着手すると、Web ブラウザというフロンティアは、少し雑草の茂るだけの荒野だと気付くでしょう。\r
+ * ここに RIA や 3D ゲームといった素晴らしいテーマパークを築機上げるには、まずは測量に整地、地盤や土壌の改良といった膨大な作業をしなくてはいけません。\r
+ * \r
+ * 簡素な物置小屋のための最初の柱を建てるのにも、それ以前に膨大な作業の必要なことに、あなたは唖然となるでしょう。\r
+ * そのような基礎もそこそこに、勇んで建てた一本目の柱は傾き、または無残に朽ち果てるのを目撃し、あなたは深いため息をつくかもしれません。\r
+ * \r
+ * Javascript は様々な問題を孕みつつも、今や最もあらゆるプラットフォームで動作する言語のひとつへと躍進しました。\r
+ * これから、このフロンティアに如何に基礎を作り、その上にテーマパークを作るのか?一緒に考えていきましょう。\r
+ * ようこそ、Web 開発の世界へ!\r
+ * \r
+ * <h4>pettanR フレームワーク API ドキュメントについて</h4>\r
+ * このAPIドキュメントには、折に触れこのような長文が登場します。\r
+ * Web 開発は今では、そのカジュアルなイメージとは裏腹に、膨大な知識と経験が必要なものになってしまっています。\r
+ * どのようにして、それらの情報を、妥当な業務時間の間に継承していけばよいか?\r
+ * \r
+ * この意識は常にありましたが、このたび pettanR フレームワークの API ドキュメントを作成するにあたり、それに付記していく形で取り組んでみようと思います。\r
+ * \r
+ * <h4>フレームワークのレイヤー構造について</h4>\r
+ * \r
+ * \r
+ * ライブラリは X という名前空間を使用します。\r
+ * @example //ショートハンド\r
+ * X( func ) == X.ViewPort.listenOnce(X.Event.XDOM_READY, func);\r
+ * X('#mydiv') == X.Doc.find('#mydiv');\r
+ * @namespace X\r
+ */ \r
+function X( v ){\r
+ if( X.Type.isFunction( v ) ){\r
+ X.ViewPort.listenOnce( X.Event.XDOM_READY, v );\r
+ } else\r
+ if( X_shortcutFunction ){\r
+ return X_shortcutFunction.apply( X_shortcutContext || X, arguments );\r
+ };\r
+};\r
+\r
//{+DEV\r
if( !window['console'] || ( window.parent && window.parent.log ) )\r
console = { log : function(a){\r
X_shortcutContext;\r
\r
/**\r
- * @namespace ライブラリは X という名前空間を使用します。X( func ) で X.ViewPort.listenOnce(X.Event.XDOM_READY, func)、 X('#mydiv') として X.Doc.find('#mydiv') のショートハンドになります。\r
- */ \r
-function X( v ){\r
- if( X.Type.isFunction( v ) ){\r
- X.ViewPort.listenOnce( X.Event.XDOM_READY, v );\r
- } else\r
- if( X_shortcutFunction ){\r
- return X_shortcutFunction.apply( X_shortcutContext || X, arguments );\r
- };\r
-};\r
-\r
+ * バージョン文字列:"0.6.123"\r
+ * @type {string} */\r
X.VERSION = '0.6.127';\r
- \r
+\r
+/**\r
+ * ブートタイム ms\r
+ * @type {number} */\r
X.bootTime = + new Date;\r
\r
+/**\r
+ * 空の関数\r
+ * @type {Function} */\r
X.emptyFunction = new Function;\r
\r
+/**\r
+ * このscriptはheadタグの中にあるか?\r
+ * @type {boolean} */\r
// TODO defer の場合もあるので、document.readyState を見る\r
// MacIE で false\r
X.inHead = (function( s ){\r
// ------------ local variables -------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
var X_UA = (function( n, undefined ){\r
- var acme = {},\r
+ var\r
+ /** @alias X.UA */\r
+ acme = {},\r
dua = n.userAgent,\r
dav = n.appVersion,\r
tv = parseFloat(dav),\r
\r
v = dua.split( 'OS ' )[ 1 ].split( '_' );\r
i = window.devicePixelRatio === 1;\r
- \r
+ /** @memberof X.UA */\r
acme.iOSMajor = parseFloat( v[ 0 ] ) || 0;\r
+ /** @memberof X.UA */\r
acme.iOSMinor = parseFloat( v[ 1 ] ) || 0;\r
+ /** @memberof X.UA */\r
acme.iOSPatch = parseFloat( v[ 2 ] ) || 0;\r
-\r
+ /** @memberof X.UA */\r
acme.iOS = acme.iOSMajor + acme.iOSMinor / 10;\r
\r
if( screen.width === screen.height * 1.5 || screen.width * 1.5 === screen.height ){\r
};\r
\r
if( sys === 'iPhone' ){\r
+ /** @memberof X.UA */\r
acme.iPhone = true;\r
- if( v ) acme.iPhone_4s = true; // 4s以下\r
- if( v && i ) acme.iPhone_3GS = true; // 3GS以下\r
+ if( v ){\r
+ /** iPhone4s以下\r
+ * @memberof X.UA */\r
+ acme.iPhone_4s = true;\r
+ };\r
+ if( v && i ){\r
+ /** iPhone3GS以下\r
+ * @memberof X.UA */\r
+ acme.iPhone_3GS = true;\r
+ };\r
//alert( 'iPhone ' + ( acme.iPhone_3GS ? '3GS以下' : acme.iPhone_4s ? '4s以下' : '5以上' ) );\r
};\r
if( sys === 'iPad' ){\r
+ /** @memberof X.UA */\r
acme.iPad = true;\r
- if( i ) acme.iPad_2Mini1 = true;\r
+ if( i ){\r
+ /**\r
+ * iPad2以下または初代iPad mini 以下\r
+ * @memberof X.UA */\r
+ acme.iPad_2Mini1 = true;\r
+ };\r
};\r
if( sys === 'iPod' ){\r
+ /** @memberof X.UA */\r
acme.iPod = true;\r
- if( v ) acme.iPod_4 = true;\r
- if( v && i ) acme.iPod_3 = true;\r
+ if( v && i ){\r
+ /**\r
+ * iPod3以下\r
+ * @memberof X.UA */\r
+ acme.iPod_3 = true;\r
+ };\r
+ if( v ){\r
+ /**\r
+ * iPod4以下\r
+ * @memberof X.UA */\r
+ acme.iPod_4 = true;\r
+ };\r
//alert( 'iPod touch ' + ( acme.iPod_3 ? '3以下' : acme.iPod_4 ? '4以下' : '5以上' ) );\r
};\r
\r
} else\r
if( dua.indexOf( 'hp-tablet' ) !== -1 || dua.indexOf( 'webOS' ) !== -1 ){\r
// http://user-agent-string.info/list-of-ua/os-detail?os=webOS\r
+ /** @memberof X.UA */\r
acme.webOS = true; // webOS\r
} else\r
if( sys.indexOf( 'Win' ) + 1 ){\r
console.log( 'Win' );\r
+ /** @memberof X.UA */\r
acme.Windows = true;\r
switch( sys ){\r
case 'Win16' :\r
} else\r
if( sys.indexOf( 'Mac' ) + 1 ){\r
console.log( 'Mac' );\r
+ /** @memberof X.UA */\r
acme.Mac = true;\r
switch( sys ){\r
case 'MacPowerPC' :\r
+ /** @memberof X.UA */\r
acme.MacPPC = true;\r
break;\r
case 'MacPPC' :\r
} else\r
if( ( sys.indexOf( 'Linux' ) + 1 ) || ( sys.indexOf( 'Android' ) + 1 ) ){\r
console.log( 'Linux' );\r
+ /** @memberof X.UA */\r
acme.Linux = true;\r
\r
if( ( i = dua.indexOf( 'Android' ) ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.Android = parseFloat( dua.substr( i + 8 ) ) || 0.1; // Firefox で Version が取れない!\r
console.log( '>> Android : ' + acme.Android );\r
};\r
if( window.opera ){\r
i = dua.indexOf( 'Opera' ); // Opera/\r
j = dua.indexOf( 'Version/' );\r
+ /** @memberof X.UA */\r
acme.Opera = Math.max(\r
i !== -1 ? parseFloat( dua.substr( i + 6 ) ) : 0,\r
j !== -1 ? parseFloat( dua.substr( j + 8 ) ) : 0,\r
tv );\r
// closure compiler で minify するとOpera7で動かない \r
// --compilation_level WHITESPACE_ONLY --formatting pretty_print <- 動く\r
+ /** @memberof X.UA */\r
acme.Opera7 = acme.Opera < 8;\r
+ /** @memberof X.UA */\r
acme.Opera78 = acme.Opera < 9;\r
+ /** @memberof X.UA */\r
acme.OperaMini = 0 < dua.indexOf('Opera Mini');\r
+ /** @memberof X.UA */\r
acme.OperaMobile = 0 < dua.indexOf('Opera Mobi');\r
+ /** @memberof X.UA */\r
acme.OperaTablet = 0 < dua.indexOf('Opera Tablet');\r
+ /** @memberof X.UA */\r
acme.Wii = dua.indexOf( 'Nintendo Wii' ) !== -1;\r
+ /** @memberof X.UA */\r
acme.NDS = dua.indexOf( 'Nitro' ) !== -1;\r
console.log( '>> Opera : ' + acme.Opera );\r
return acme;\r
\r
// Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko\r
if( document.all || dav.indexOf( 'Trident/' ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.ActiveX = !!window[ 'ActiveXObject' ];\r
+ /**\r
+ * documentモードを考慮しないIEのバージョン\r
+ * @memberof X.UA\r
+ * @type {number}*/\r
acme._IE = parseFloat(dua.split('MSIE ')[1]) || parseFloat(dua.split('rv:')[1]) || parseFloat(dav.split('MSIE ')[1]) || 0;\r
// IE11 の互換モードの dav にも Trident/7.0 が書かれているため互換モードか?判定ができる\r
// 互換モードでは Silverlight でエラーが出る?\r
+ /** @memberof X.UA */\r
acme.Trident = parseFloat(dav.split('Trident/')[1]) || 0;\r
+ /**\r
+ * documentモードを考慮したIEのバージョン\r
+ * @memberof X.UA */\r
acme.IE = document.documentMode || acme._IE;\r
tridentToVer = acme.Trident ? ( acme.Trident + 4 | 0 ) : acme._IE;\r
+ /**\r
+ * IE11 の互換モードを使用しているか?\r
+ * @memberof X.UA */\r
acme.IECompat = /* acme.IE !== acme._IE || */ tridentToVer !== acme._IE && tridentToVer;\r
+ /** @memberof X.UA */\r
acme.IE4 = acme.IE && acme.IE < 5;\r
+ /** @memberof X.UA */\r
acme.IE5678 = 5 <= acme.IE && acme.IE < 9;\r
+ /** @memberof X.UA */\r
acme.IE5 = 5 <= acme.IE && acme.IE < 5.5;\r
+ /** @memberof X.UA */\r
acme.IE55 = 5.5 <= acme.IE && acme.IE < 6;\r
+ /** @memberof X.UA */\r
acme.IE5x = acme.IE5 || acme.IE55;\r
+ /** @memberof X.UA */\r
acme.IE6 = 6 <= acme.IE && acme.IE < 7;\r
+ /** @memberof X.UA */\r
acme.IE7 = 7 <= acme.IE && acme.IE < 8;\r
+ /** @memberof X.UA */\r
acme.IE8 = 8 <= acme.IE && acme.IE < 9;\r
+ /** @memberof X.UA */\r
acme.IE9 = 9 <= acme.IE && acme.IE < 10;\r
+ /** @memberof X.UA */\r
acme.MacIE = acme.Mac;\r
+ /** @memberof X.UA */\r
acme.IEMobile = dua.toLowerCase().indexOf( 'iemobile' ) !== -1 || acme.WinCE;\r
+ /** @memberof X.UA */\r
acme.WinPhone = dua.toLowerCase().indexOf( 'windows phone' ) !== -1 || 0 < dav.indexOf( 'ZuneWP' ); // ZuneWP は IEM のデスクトップモードで使用\r
console.log( '>> IE : ' + acme.IE + ' ActiveX : ' + acme.ActiveX );\r
// TODO XBox360, XBox1, Modern or Desktop, Standalone\r
\r
// http://qa.support.sony.jp/solution/S0812181056444/common/nfb34_dom_200jp/dom_dom0_JP.html\r
if( ( i = dua.indexOf( 'NetFront\/' ) !== -1 ) ){\r
+ /** @memberof X.UA */\r
acme.NetFront = parseFloat( dua.substr( i + 9 ) ) || 0.1;\r
console.log( '>> NetFront : ' + acme.NetFront );\r
return acme;\r
// https://github.com/Famous/famous/blob/1a02c8084587d80519ea4bd3b55649ab32ee2e65/examples/assets/lib/require.js\r
// PS3 ブラウザのロードイベントについて\r
if( ( i = dua.toUpperCase().indexOf( 'PLAYSTATION 3' ) !== -1 ) ){\r
+ /**\r
+ * PlayStation 3 システムバージョン 4.10 未満の SONY 独自ブラウザ\r
+ * @memberof X.UA */\r
acme.PS3 = parseFloat( dua.substr( i + 15 ) ) || 0.1;\r
console.log( '>> PS3 : ' + acme.PS3 );\r
return acme;\r
// iCab/3.0.2 (Macintosh; U; PPC Mac OS X)\r
// Mozilla/5.0 (Macintosh; U; PPC Mac OS; en) iCab 3\r
if( ( i = dua.indexOf( 'iCab' ) !== -1 ) ){\r
+ /** @memberof X.UA */\r
acme.iCab = parseFloat( dua.substr( i + 5 ) ) || 0.1;\r
console.log( '>> iCab : ' + acme.iCab );\r
return acme;\r
\r
if( 0 < dua.indexOf( 'Gecko\/' ) && ( i = dua.indexOf( 'rv:' ) ) ){\r
v = dua.substr( i + 3 ).split( '.' );\r
+ /** @memberof X.UA */\r
acme.Gecko = parseFloat( v[ 0 ] ) || 0 +\r
( parseFloat( v[ 1 ] ) || 0 ) / 10 +\r
( parseFloat( v[ 2 ] ) || 0 ) / 100;\r
- \r
+ /** @memberof X.UA */\r
acme.GeckoMajor = parseFloat( v[ 0 ] ) || 0;\r
+ /** @memberof X.UA */\r
acme.GeckoMinor = parseFloat( v[ 1 ] ) || 0;\r
+ /** @memberof X.UA */\r
acme.GeckoPatch = parseFloat( v[ 2 ] ) || 0;\r
\r
//Fennec\r
// Mozilla/5.0 (Android; Linux armv7l; rv:9.0) Gecko/20111216 Firefox/9.0 Fennec/9.0\r
if( ( i = dua.indexOf( 'Fennec/' ) ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.Fennec = parseFloat( dua.substr( i + 7 ) );\r
console.log( '>> Fennec : ' + acme.Fennec + ', Gecko : ' + acme.Gecko );\r
return acme;\r
//Netscape\r
//Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:0.9.4.1) Gecko/20020508 Netscape6/6.2.3\r
if( ( i = dua.indexOf( 'Netscape6/' ) ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.NN = parseFloat( dua.substr( i + 10 ) ) || 6;\r
+ /** @memberof X.UA */\r
acme.NN6 = true;\r
console.log( '>> NN : ' + acme.NN + ', Gecko : ' + acme.Gecko );\r
return acme;\r
\r
// TODO Blink\r
if( window.chrome ){\r
+ /** @memberof X.UA */\r
acme.Blink = tv;\r
console.log( '>>Blink : ' + acme.Blink );\r
\r
} else\r
if( dav.indexOf( 'Konqueror' ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.Khtml = tv;\r
console.log( '>>Khtml : ' + acme.Khtml );\r
\r
} else\r
if( ( i = dua.indexOf( 'Android ' ) ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser = i = parseFloat( dua.substr( i + 8 ) ) || 0.1;\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser1 = 1 <= i && i < 2;\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser2 = 2 <= i && i < 3;\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser3 = 3 <= i && i < 4;\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser4 = 4 <= i && i < 5;\r
+ /** @memberof X.UA */\r
acme.AndroidBrowser5 = 5 <= i && i < 6;\r
console.log( '>> AndroidBrowser : ' + acme.Android );\r
\r
i = parseFloat(dua.split('WebKit\/')[1]);\r
+ /** @memberof X.UA */\r
acme.AndroidBrowserWebkit = i;\r
alert( 'AudioSprite調査:Android標準ブラウザ Webkit Version ' + i );\r
\r
} else\r
if( i = parseFloat(dua.split('WebKit\/')[1]) ){\r
+ /** @memberof X.UA */\r
acme.WebKit = i;\r
- \r
+ /** @memberof X.UA */\r
acme.Chrome = parseFloat(dua.split('Chrome\/')[1]) || undefined;\r
\r
// TODO webkit Opera\r
\r
if( i && !acme.Chrome && dua.indexOf( 'Safari' ) !== -1 ){\r
if( dav.indexOf( 'Version/' ) !== -1 ){\r
+ /** @memberof X.UA */\r
acme.Safari = parseFloat( dav.split('Version/')[1] );\r
} else {\r
if( i < 73 ){\r
dua.indexOf( 'Kindle' ) !== -1 ||\r
// Sony Reader Mozilla/5.0 (Linux; U; ja-jp; EBRD1101; EXT) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1\r
dua.indexOf( 'EBRD' ) !== -1\r
- ) acme.EInk = true; \r
- \r
+ ){\r
+ /** @memberof X.UA */\r
+ acme.EInk = true;\r
+ };\r
return acme;\r
})( navigator ),\r
\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
+\r
+/**\r
+ * UserAgent の関する定数を保持する。\r
+ * @namespace X.UA\r
+ * @alias X.UA\r
+ * @type {object}\r
+ */\r
X.UA = X_UA;\r
\r
// TODO 構文のサポート instanceof, in, try catch\r
-/*\r
+/**\r
* http://pettanr.sourceforge.jp/test/type.html\r
+ * ビルトイン方の判定に使用する関数を集めたもの。ブラウザのネイティブな判定関数には不可解な挙動があるので、X.Type を使用するほうがよい。\r
* \r
- * need xua\r
+ * @namespace X.Type\r
+ * @alias X.Type\r
*/\r
-\r
X.Type = {\r
+ /**\r
+ * Object か?判定する。typeof null === 'object' に対策済なので null は Object ではない。\r
+ */\r
isObject : function( v ){\r
return v && typeof v === 'object'; // typeof null === 'object' に対策\r
},\r
- \r
+ /**\r
+ * Function か?判定する。\r
+ */\r
isFunction : function( v ){\r
return typeof v === 'function';\r
},\r
- \r
+ /**\r
+ * ie の XHR.open 等ビルトインオブジェクトか?判定する。\r
+ */\r
isUnknown : function( v ){\r
- return typeof v === 'unknown'; // ie の XHR.open など\r
+ return typeof v === 'unknown';\r
},\r
- \r
+ /**\r
+ * Array か?判定する。argumnets 等のファイク Array は false なので注意。\r
+ * @funciton\r
+ */\r
isArray :\r
new Function( 'v',\r
X_UA.IE < 5.5 || X_UA.NetFront < 4 ? // netfront3.4 は html に instanceof をすると error になる\r
'return v&&Object.prototype.toString.call(v)==="[object Array]"' :\r
'return v instanceof Array'\r
),\r
- \r
+ /**\r
+ * 真偽値か?判定する。\r
+ */\r
isBoolean : function( v ){\r
return v === true || v === false;\r
},\r
- \r
+ /**\r
+ * 文字列か?判定する。\r
+ */\r
isString : function( v ){\r
return typeof v === 'string'; // v === v + ''; // 文字列の加算は IE で遅いかも。\r
},\r
- \r
+ /**\r
+ * 数値値か?判定する。\r
+ */\r
isNumber : function( v ){\r
return typeof v === 'number'; // v !== v || v + 0 === v;\r
},\r
- \r
+ /**\r
+ * finite か?判定する。isFinite( '123' ) === true に対策済。\r
+ */\r
isFinite : function( v ){\r
- return typeof v === 'number' && isFinite( v ); // isFinite( '123' ) === true に対策\r
+ return typeof v === 'number' && isFinite( v );\r
},\r
- \r
+ /**\r
+ * NaN か?判定する。isNaN( 'NaN' ) === true に対策済。\r
+ */\r
isNaN : function( v ){\r
- return v !== v; // isNaN( 'NaN' ) === true に対策\r
+ return v !== v;\r
},\r
- \r
+ /**\r
+ * HTMLElement か?判定する。\r
+ * @funciton\r
+ */\r
isHTMLElement :\r
new Function( 'v',\r
( X_UA.IE4 || X_UA.MacIE ) ?\r
return (Object.prototype.toString.call(v) === "[object HTMLCollection]");\r
},\r
*/\r
+ /**\r
+ * Null か?判定する。\r
+ */\r
isNull : function( v ){\r
return v === null;\r
},\r
- \r
+ /**\r
+ * undefined か?判定する。\r
+ */\r
isUndefined : function( v ){\r
return v === void 0;\r
}\r
-\r
+/**\r
+ * name in object 構文が使えない環境で構文解析エラーを回避するためにこのメソッドを使用します。\r
+ * 但し for( name in object ) については構文解析エラーになる環境はありません。\r
+ * @alias X.Object.inObject\r
+ * @function\r
+ * @param {string} name \r
+ * @param {object} obj \r
+ * @return {boolean} name が定義されている(値が undefined や null でも) -> true\r
+ */\r
var X_Object_inObject = X_UA.IE < 5.5 ? // TODO JScript で判定\r
(function( name, obj ){\r
var p;\r
}) :\r
new Function( 'a,b', 'return a in b' );// なぜか ie5 でもerror\r
\r
-\r
+/**\r
+ * Object に関するメソッドを集めたものです。\r
+ * @namespace X.Object\r
+ * @alias X.Object\r
+ */\r
X.Object = {\r
+ // TODO rename to copy\r
clone : X_Object_clone,\r
\r
override : X_Object_override,\r
\r
deepCopy : X_Object_deepCopy,\r
\r
+ // TODO rename to X.Array.copy\r
cloneArray : X_Object_cloneArray,\r
\r
isEmpty : X_Object_isEmpty,\r
\r
inObject : X_Object_inObject\r
-};\r
\r
+ // TODO hasOwnProperty\r
+};\r
+\r
+/**\r
+ * 単純なクローンでメンバーをコピーしたオブジェクトを返します。\r
+ * @alias X.Object.clone\r
+ * @param {object|Array} src コピー元のオブジェクトです。\r
+ * @return {object|Array}\r
+ */\r
function X_Object_clone( src ){\r
var ret, k;\r
if( typeof src !== 'object' ) return src;\r
return ret;\r
};\r
\r
+/**\r
+ * オブジェクトにオブジェトのメンバーをコピーします。同じ名前のメンバーは上書きされます。\r
+ * @alias X.Object.override\r
+ * @param {object} target コピーされるオブジェクトです。返り値はこのオブジェクトです。\r
+ * @param {object} src コピー元のオブジェクトです。\r
+ * @return {object} target が返る。\r
+ */\r
function X_Object_override( target, src ){\r
var k;\r
if( !X.Type.isObject( src ) ) return target;\r
return target;\r
};\r
\r
+/**\r
+ * オブジェクト(object, Array)のメンバーを探索して、ディープコピーしたオブジェクトを返します。\r
+ * オブジェクトが循環参照している場合は、既にコピーしているオブジェクトが現れた時点で、先に作成しているコピーの参照を返すので無限にループすることはありません。\r
+ * @alias X.Object.deepCopy\r
+ * @param {object|Array} src コピー元のオブジェクトです。\r
+ * @return {object|Array}\r
+ */\r
function X_Object_deepCopy( src ){ \r
return X_Object_deepCopy_( src, [], [], -1 );\r
};\r
return ret;\r
};\r
\r
+/**\r
+ * 単純にメンバーをコピーした Array を返します。\r
+ * @alias X.Object.cloneArray\r
+ * @param {Array} ary コピー元のオブジェクトです。\r
+ * @return {Array}\r
+ */\r
function X_Object_cloneArray( ary ){\r
var ret = [],\r
i = ary.length;\r
};\r
return ret;\r
};\r
- \r
+\r
+/**\r
+ * object が空か?調べます。\r
+ * @alias X.Object.isEmpty\r
+ * @param {object} v \r
+ * @return {boolean}\r
+ */\r
function X_Object_isEmpty( v ){\r
var k;\r
for( k in v ){\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
+\r
+/**\r
+ * @namespace X.String\r
+ * @alias X.String\r
+ */\r
X.String = {\r
\r
parse : X_String_parse,\r
\r
chrReferanceTo : X_String_chrReferanceTo,\r
\r
- toChrReferance : X_String_toChrReferance\r
+ toChrReferance : X_String_toChrReferance,\r
+ \r
+ isNumberString : X_String_isNumberString\r
};\r
\r
// ------------------------------------------------------------------------- //\r
.split( ' ' ).join( ' ' );\r
};\r
\r
+function X_String_isNumberString( v ){\r
+ var n = v - 0;\r
+ return '' + n === v || '' + n === '0' + v;\r
+};\r
+\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
+\r
+/**\r
+ * @namespace X.URL\r
+ * @alias X.URL\r
+ */\r
X.URL = {\r
\r
BASE_URL : X_URL_BASE_URL,\r
*/\r
var listener;\r
\r
-/*\r
- * コールバックに thisObject や、追加の引数を設定するための情報を収めたハッシュ\r
- * @typedef {{ k : number, f : (function|undefined), x : (listener|undefined), s : (Array|undefined) }}\r
+/**\r
+ * <h4>クロージャについて</h4>\r
+ * javascript 開発で多用されるクロージャですが、次の理由によりその使用は慎重になるべきです。\r
+ * <ol>\r
+ * <li>正しく参照を切ってガベージコレクトされる条件を満たしたか?プログラマが見落としやすく、結果メモリリークを起こしやすい。特にコードがコールバック地獄になると目も当てられない。\r
+ * </ol>\r
+ * \r
+ * とくに次のようなページでは、クロージャの使用を極力避けるべきです。破棄が行われることが確実で即時関数によって新しい名前を追加したくない場合と、次項で紹介する絶対に必要なケース以外で使わないようにします。\r
+ * <ol>\r
+ * <li>ajax によりデータ取得がたびたび起こり、合わせて不要なデータの破棄も行う。\r
+ * <li>シングルページアプリケーションで画面の生成と破棄が繰り返される。\r
+ * <li>Web アプリケーションで、一度開いたら一日中操作し続けるユーザーも想定される。\r
+ * </ol>\r
+ * \r
+ * <h4>クロージャが絶対に必要な場合</h4>\r
+ * IE5 ~ IE8 の独自イベントモデルに於いて、イベントオブジェクトに event.currentTarget に相当するものがなく、現在どの HTML 要素でイベントが起こっているか分かりません。<br>\r
+ * そのため HTML 要素とコールバック関数を束縛するクロージャを使う必要があります。<br>\r
+ * 参照:『Javascript 第5版』 オライリー p430 17.3.6 attachEvent() と this キーワード<br>\r
+ * \r
+ * このほかに IE8 以下と Opera11 以下の XHR ではイベントオブジェクトが用意されないため、eventType が分からない問題があります。このために eventType とコールバック関数を束縛するクロージャが必要です。<br>\r
+ * \r
+ * このように、Web ブラウザと javascript の接点では、どうしてもクロージャが必要なケースがあります。<br>\r
+ * さて、クロージャの使用を最小限に留め、残った僅かなクロージャのメモリリークをチェックし、といくら慎重に開発を行っても、そもそもクロージャが破棄されるのか?ガベージコレクションの怪しいブラウザもあり問題はまだ続きます。\r
+ * \r
+ * <h4>再利用可能なクロージャ</h4>\r
+ * クロージャの使用を最小限にしたうえで、なおかつクロージャがガベージコレクションされない可能性を考慮して、pettanR フレームワークでは再利用可能なクロージャを用意します。<br>\r
+ * 再利用可能クロージャはフレームワーク内で生成・破棄されるため、ユーザーが直接触ることはありません。しかし debug ツールのコールスタックには登場するため、知識を持っておくことは有益です。<br>\r
+ * \r
+ * <h5>再利用可能クロージャの作成</h5>\r
+ * X_Callback_create() で再利用可能なクロージャの作成。次のパターンで呼び出します。<br>\r
+ * 最大で三つの引数を並べる一連のパターンは、 EventDispatcher.listen unlisten, listening や X.Timer.add, once でも使われますので、ここでよく目を通しておきます。\r
+ * \r
+ * <table>\r
+ * <tr><th>this コンテキスト+関数<td>X_Callback_create( thisObject, func )<td>func.call( thisObject );\r
+ * <tr><th>this コンテキスト+関数+追加引数<td>X_Callback_create( thisObject, func, [ arg1, ...args ] )<td>func.apply( thisObject, [ arg1, ...args ] );\r
+ * <tr><th>listener オブジェクト<td>X_Callback_create( listener )<td>listener.handleEvent(); コールバックに関数でなく handleEvent 関数をメンバに持つオブジェクトを渡すのは NN4 からある javascript のお約束です。\r
+ * <tr><th>listener オブジェクト+追加引数<td>X_Callback_create( listener, [ arg1, ...args ] )<td>listener.handleEvent.apply( listener, [ arg1, ...args ] );\r
+ * <tr><th>関数<td>X_Callback_create( func )<td>特別な操作は不要なので再利用可能クロージャは作られません。func をそのまま利用します。\r
+ * <tr><th>関数+引数<td>X_Callback_create( func, [ arg1, ...args ] )<td>func.apply( ?, [ arg1, ...args ] );\r
+ * </table>\r
+ * \r
+ * <h5>再利用可能クロージャの破棄と再利用</h5>\r
+ * X_Callback_correct() によってクロージャは回収され再利用に備えます。<br>\r
+ * 実は、クロージャが束縛するのは、this コンテキストやコールバック関数といった、<strong>そのもの</strong>ではなく、それらを一定のルールで格納したハッシュです。<br>\r
+ * このハッシュはクロージャに与えた後も、適宜に取得が可能です。このハッシュのメンバーを書き換えることで、クロージャの this コンテキストやコールバック関数を書き換えています。\r
+ * \r
+ * @class __CallbackHash__\r
+ * @classdesc コールバック関数に this コンテキストや、追加の引数を設定するための情報を収めたハッシュです。<br>\r
+ * フレームワークユーザは直接触ることにはないが、重要な情報なので書いておきます。\r
+ * @private\r
*/\r
-var callbackHash;\r
-\r
+var __CallbackHash__ =\r
+/** @lends __CallbackHash__.prototype */\r
+{\r
+ /**\r
+ * コールバックの種類を表す数値。 this + function, this.handleEvent, function only がある。\r
+ * @type {number} \r
+ */\r
+ kind : X_Callback_THIS_FUNC,\r
+ /**\r
+ * コールバック。\r
+ * @type {funciton|undefined} \r
+ */\r
+ func : undefined,\r
+ /**\r
+ * コールバックの this コンテキスト。 \r
+ * @type {listener|object|undefined}\r
+ */\r
+ context : undefined,\r
+ /**\r
+ * コールバックに追加する引数。イベントのコールバックでは event オブジェクトのあとに追加されるため supplement[0] が第一引数にならない点に注意。\r
+ * @type {Array|undefined}\r
+ */\r
+ supplement : undefined,\r
+ /**\r
+ * __CallbackHash__ の情報を元に、コールバックを実施するプロキシ。\r
+ * @type {Function}\r
+ */\r
+ proxy : X_Callback_proxyCallback\r
+};\r
\r
+/**\r
+ * X.Timer と X.EventDispatcher からのコールバックの返り値を定義。\r
+ * @namespace X.Callback\r
+ * @alias X.Callback\r
+ */\r
X.Callback = {\r
+ /**\r
+ * このコールバックでは返り値による操作は無い。\r
+ */\r
NONE : X_Callback_NONE,\r
+ /**\r
+ * X.Timer.add, X.EventDispatcher.listen のコールバックでタイマーやイベントリスナの解除に使用。\r
+ */\r
UN_LISTEN : X_Callback_UN_LISTEN,\r
+ /**\r
+ * イベントのバブルアップを中止する。DOM イベントのコールバックの戻り値に指定すると e.stopPropagation() が呼ばれる。\r
+ */\r
STOP_PROPAGATION : X_Callback_STOP_PROPAGATION,\r
+ /**\r
+ * 以降のイベントのディスパッチを中断する。\r
+ */\r
STOP_NOW : X_Callback_STOP_NOW,\r
+ /**\r
+ * DOM イベントのコールバックの戻り値に指定すると e.preventDefault() が呼ばれる。\r
+ * またフレームワーク内で定義されたデフォルト動作の回避にも使用される。\r
+ */\r
PREVENT_DEFAULT : X_Callback_PREVENT_DEFAULT,\r
+ /**\r
+ * X.UI に於いて、ポインターイベントの戻り値に指定すると、以降のポインターベントを独占する。\r
+ */\r
MONOPOLY : X_Callback_MONOPOLY\r
};\r
\r
-/**\r
- * Class を定義し システムの管理下に置く.\r
- * 全てのクラスと pool が有効の場合インスタンスへの参照が保持される.\r
- * 1. X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録.\r
- * 2. コンストラクタ となるメソッドは、opt_props 内の Constructor : function( arg ){ ... }, に書く.\r
- * 3. 通常通り new で インスタンス生成\r
- * 4. kill() でオブジェクトをクリーンして削除、pool が有効の場合は pool される.\r
- * 5. pool が有効の場合、new で pool されたインスタンスが返される.\r
- * 6. \r
- * \r
- */\r
\r
// ------------------------------------------------------------------------- //\r
// ------------ local variables -------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
-var X_Class_CLASS_LIST = [],\r
+var\r
+ /**\r
+ * 全てのクラスのスーパークラスのようなもの。(ライブラリ内にカプセル化されているため、ユーザが触ることはありません)<br>\r
+ * X.Class.create() で定義されたクラスのインスタンスが共通で備えるメソッド を確認してください。\r
+ * @class __ClassBase__\r
+ * @private\r
+ * @abstract\r
+ */\r
+ __ClassBase__ = {\r
+ /**\r
+ * クラス名\r
+ * @type {string}\r
+ */\r
+ name : ''\r
+ },\r
+\r
+ X_Class_CLASS_LIST = [],\r
X_Class_DEF_LIST = [],\r
X_Class_PRIVATE_CLASS_LIST = [],\r
X_Class_PRIVATE_DEF_LIST = [],\r
X_Class_use_proto_ = !X_UA.OperaMobile && !X_UA.OperaTablet && !!X.emptyFunction.prototype.__proto__,\r
// Opera Mobile 12.10 Android11 IS01 でクラスのメンバが欠落する問題に遭遇。__proto__ を使わないと動作,,,\r
\r
-/** \r
- * X.Class.create で定義されたクラスのインスタンスが共通で備えるメソッド を格納\r
- *\r
- * @class\r
- */ \r
-X_Class_CommonProps =\r
-\r
+X_Class_CommonMethods =\r
+/** @lends __ClassBase__.prototype */\r
{\r
- /*\r
- * インスタンスの破棄。\r
- * TODO kill したインスタンスのイベントが残っていないか?これは開発用のみ\r
+ /**\r
+ * 全ての動的メンバを削除して、インスタンスを破棄する。<br>\r
+ * インスタンスが X.EventDispatcher とそのサブクラスの場合、次の動作をする。\r
+ * <ol>\r
+ * <li>X.Event.BEFORE_KILL_INSTANCE を発火する。戻り値のビットフラグに X.Callback.PREVENT_DEFAULT が立つ場合、破棄をキャンセルし X.Event.KILL_INSTANCE_CANCELED を発火する。\r
+ * <li>破棄に進む場合は、X.Event.KILL_INSTANCE を発火する。\r
+ * <li>dispatch 中は、インスタンスの全ての dispatch が終了するまで実際の破棄を待つ。\r
+ * <li>実際の破棄では、インスタンスのメンバの削除に加えて全てのイベントリスナを解除する。\r
*/\r
+ // TODO kill したインスタンスのイベントが残っていないか?これは開発用のみ\r
kill : function(){\r
var instance = this,\r
klass = X_Class_getClass( instance ),\r
};\r
X_Class_killPrivateFlag = false; // instance.kill() 内で PrivateInstance.kill() を防ぐため\r
\r
- // X.EventDispatcher とそのサブクラスは kill() が呼ばれた通知を発行する。\r
- // X.Event.BEFORE_KILL_INSTANCE はキャンセル可能(private な class は不可)\r
- // X.Event.KILL_INSTANCE は、プロパティやイベントリスナの削除直前に発行\r
- // X.Event.KILL_INSTANCE_CANCELED は kill() がキャンセルされた場合に発行。また dispatchループ中にkill()が呼ばれると一旦キャンセルされ発行。\r
- // (flagを立ててdispatchの終わりにkillする)\r
if( this.instanceOf( X.EventDispatcher ) ){\r
if( !def.isPrivate ){\r
- if( this[ '_listeners' ] && this[ '_listeners' ]._dispatching ){\r
- this.dispatch( X.Event.BEFORE_KILL_INSTANCE );\r
- this[ '_listeners' ]._killReserved = true;\r
- this.dispatch( X.Event.KILL_INSTANCE_CANCELED );\r
- return;\r
- } else\r
if( this.dispatch( X.Event.BEFORE_KILL_INSTANCE ) & X.Callback.PREVENT_DEFAULT ){\r
this.dispatch( X.Event.KILL_INSTANCE_CANCELED );\r
return;\r
};\r
+ if( this[ '_listeners' ] && this[ '_listeners' ][ X_Listeners_.DISPATCHING ] ){\r
+ this[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
+ return;\r
+ };\r
} else {\r
this.dispatch( X.Event.BEFORE_KILL_INSTANCE ); \r
};\r
+\r
+ // asyncDispatch の削除\r
+ for( p in X_EventDispatcher_LAZY_TIMERS ){\r
+ if( X_EventDispatcher_LAZY_TIMERS[ p ] === this ){\r
+ delete X_EventDispatcher_LAZY_TIMERS[ p ]; // 削除が先!理由は X.Timer.removeを確認。\r
+ X.Timer.remove( parseFloat( p ) );\r
+ };\r
+ };\r
+ \r
this.dispatch( X.Event.KILL_INSTANCE );\r
- this._listeners && X_EventDispatcher_systemUnlisten( this ); //.unlisten();\r
+ this._listeners && X_EventDispatcher_systemUnlisten( this );\r
};\r
\r
for( p in instance ){\r
if( i !== -1 ){\r
data = X_Class_getPrivate( instance );\r
X_Class_killPrivateFlag = true;\r
- if( data[ '_listeners' ] && data[ '_listeners' ]._dispatching && data.instanceOf( X.EventDispatcher ) ){\r
- data[ '_listeners' ]._killReserved = true;\r
+ if( data[ '_listeners' ] && data[ '_listeners' ][ X_Listeners_.DISPATCHING ] && data.instanceOf( X.EventDispatcher ) ){\r
+ data[ '_listeners' ][ X_Listeners_.KILL_RESERVED ] = true;\r
} else {\r
data.kill();\r
};\r
};\r
},\r
\r
- /* クラス定義を辿ってスーパークラスのコンストラクタを探す。\r
- * 呼び出したコンストラクタは配列に控える。\r
- * さらに呼ばれた場合、配列を元にさらに奥のコンストラクタを取得\r
- * TODO 現在 new しているインスタンスを保持してチェックする\r
+ /**\r
+ * 関数は Constructor 内で使用します。クラス定義を辿ってスーパークラスのコンストラクタを探します。<br>\r
+ * 内部的には、呼び出したコンストラクタは配列に控え(X_Class_CALLING_SUPER)、呼び出したコンストラクタ内でさらに Super が呼ばれた場合、配列を元にさらにスーパーなコンストラクタを辿ります。\r
+ * @example Constructor : function( arg1, arg2 ){\r
+ * this.Super( aeg1, arg2 );\r
+ * }\r
+ * @param var_args {...?} 親コンストラクタを呼ぶ際に渡す任意の数の引数\r
+ * @return {*}\r
*/\r
- Super : function(){\r
+ // TODO 現在 new しているインスタンスを保持してチェックする\r
+ Super : function( var_args ){\r
var sClass = this,\r
i = X_Class_CALLING_SUPER.indexOf( sClass ),\r
n = -1,\r
console.log( 'スーパークラスのコンストラクタが見つかりません' );\r
},\r
\r
- /*\r
- * func について、親クラスで設定されている同名の関数メンバーを呼び出す\r
- * 2つ以上の異なる名前で同じ関数がメンバーだった場合、失敗します\r
- * 例) this.superCall( arguments.callee, param0, param1, ... )\r
+ /**\r
+ * func について、親クラスで設定されている同名の関数メンバーを呼び出す。<br>\r
+ * 第一引数に関数を指定し、2つ以上の異なる名前で同じ関数がメンバーがいた場合、動作が不確実になります。<br>\r
+ * 参考:<a href="http://qiita.com/no22@github/items/d3bead2acbb7ff1fb86b" target="_blank">ES5なJavascriptでモダンなクラス的継承&スーパー呼び出し </a>\r
+ * @param funcNameOrFunc {Function|string} スーパークラスの関数名 または、オーバーライド済の自身の関数。\r
+ * @param var_args {...*} オーバーライド元関数に渡す任意の数の引数\r
+ * @example return this.superCall( arguments.callee, param0, param1, ... );\r
+ * @return {*} オーバーライド元の関数を呼び出した戻り値。\r
*/\r
- superCall : function( func /* ...args */ ){\r
+ superCall : function( funcNameOrFunc, var_args ){\r
var sClass = this,\r
args = arguments,\r
name, p, sFunc, hit = false;\r
- if( X.Type.isFunction( func ) ){\r
- for( p in this ){\r
- if( this[ p ] === func ){\r
+ if( X.Type.isFunction( funcNameOrFunc ) ){\r
+ for( p in this.constructor.prototype ){\r
+ if( this.constructor.prototype[ p ] === funcNameOrFunc ){\r
name = p;\r
break;\r
};\r
def = X_Class_getClassDef( sClass );\r
sClass = def.SuperClass;\r
sFunc = sClass.prototype[ name ];\r
- if( sFunc === func ){\r
+ if( sFunc === funcNameOrFunc ){\r
hit = true; // 現在の関数にヒット\r
} else\r
if( hit && X_Object_inObject( name, this ) ){\r
};\r
},\r
\r
- /*\r
- * TODO instanceof に対応したブラウザはそちらを使用\r
+ /**\r
+ * インスタンスのクラスか?またはスーパークラスか?調べる。<br>\r
+ * instanceof 構文をサポートしない環境(IE4,Mac IE5)を想定する場合、必ずこのメソッドを使用すること。<br>\r
+ * クラスのインスタンスか?だけ調べたい場合は this.constructor === klass が高速。\r
+ * @param klass {__ClassBase__} クラス定義\r
+ * @return {boolean}\r
*/\r
+ // TODO instanceof に対応したブラウザはそちらを使用\r
instanceOf : function( klass ){\r
var Super = this;\r
if( this.constructor === klass ) return true;\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
\r
-/** @namespace */ \r
+/**\r
+ * Class を定義し システムの管理下に置く.<br>\r
+ * 全てのクラスと pool が有効の場合インスタンスへの参照が保持される.\r
+ * <ol>\r
+ * <li>X.Class.create( opt_settings, opt_name, opt_privateClass, opt_props ) でクラスを登録.\r
+ * <li>コンストラクタ となるメソッドは、opt_props 内の Constructor : function( arg ){ ... }, に書く.\r
+ * <li>通常通り new で インスタンス生成\r
+ * <li>kill() でオブジェクトをクリーンして削除、pool が有効の場合は pool される.\r
+ * <li>pool が有効の場合、new で pool されたインスタンスが返される.\r
+ * @namespace X.Class\r
+ * @alias X.Class\r
+ */ \r
X.Class = {\r
- \r
+\r
+ /**\r
+ * 設定なし。\r
+ */ \r
NONE : 0,\r
\r
/**\r
* インスタンスは破棄時(this.kill())に回収され、次回の new MyClass() 時に再利用されます。\r
- * @memberof X.Class */\r
+ */\r
POOL_OBJECT : 1,\r
\r
/**\r
* 定義するクラスは抽象クラスになります。new AbstractClass() とするとエラーになります。\r
- * @memberof X.Class */\r
+ */\r
ABSTRACT : 2,\r
- \r
- \r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * クラスの継承を禁止する。\r
+ */\r
FINAL : 4,\r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * 使用を中止。petanR ライブラリ使用プロジェクトから SUPER_ACCESS を消したらここも削除。\r
+ */\r
SUPER_ACCESS : 8,\r
- /** @memberof X.Class */\r
+\r
+ /**\r
+ * 内部コード、主に X.UI フレームワークに対して、フレーム外に露出するインスタンスとペアで動作する、シャドウなインスタンスの使用を宣言する。\r
+ * Javascript はインスタンス毎のカプセル化がとてもコスト高。微妙なコスト増で隠蔽されたインスタンスを使う。\r
+ */\r
PRIVATE_DATA : 16,\r
- /** @memberof X.Class */\r
- SINGLETON : 32, // 未実装\r
- \r
- create : function( /* displayName, classSetting, opt_PrivateClass, props */ ){\r
+\r
+ /**\r
+ * 未実装。でも目印になるので付けておきましょう。\r
+ */\r
+ SINGLETON : 32,\r
+\r
+ /**\r
+ * クラスを定義する。<br>\r
+ * X.Class.create() によるクラス定義は必ずしもコンストラクタを必要としません。クラス定義時にコンストラクタが未設定の場合、スーパークラスがあればそのコンストラクタを使用します。\r
+ * @param {string} [displayName] クラスの名前\r
+ * @param {number} [classSetting=0] X.Class.POOL_OBJECT | X.Class.FINAL など\r
+ * @param {__ClassBase__=} [privateClass] このクラスとペアで動作するシャドウクラス\r
+ * @param {object} [props={}] このクラスのメンバと関数。コンストラクタは Constructor と書くこと\r
+ * @return {__ClassBase__}\r
+ */\r
+ create : function( /* displayName, classSetting, privateClass, props */ ){\r
var args = X_Object_cloneArray( arguments ),\r
displayName = args[ 0 ],\r
classSetting,\r
klass.subClassOf = X_Class_subClassOf;\r
\r
if( X_Class_useObjectCreate ){\r
- klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonProps, false );\r
+ klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
klass.prototype.constructor = klass;\r
} else\r
if( X_Class_use_proto_ ){\r
if( X_Class_traits ){\r
klass.prototype.__proto__ = X_Class_traits;\r
} else {\r
- X_Class_override( klass.prototype, X_Class_CommonProps, false );\r
+ X_Class_override( klass.prototype, X_Class_CommonMethods, false );\r
};\r
} else {\r
- klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonProps, false );\r
+ klass.prototype = X_Class_override( X_Class_override( X_Class_traits || klass.prototype, props, true ), X_Class_CommonMethods, false );\r
klass.prototype.constructor = klass;\r
};\r
+ \r
klass.name = displayName;\r
\r
if( opt_abstract ){\r
\r
};\r
\r
+\r
+\r
// ------------------------------------------------------------------------- //\r
// --- implements ---------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
X.Logger.critical( p + ' is reserved!' );\r
return;\r
};\r
- if( force || target[ p ] === void 0 ){\r
+ if( force || target[ p ] === undefined ){\r
target[ p ] = src[ p ];\r
};\r
};\r
return target;\r
};\r
\r
+/**\r
+ * スーパークラスか?調べます。\r
+ * @alias __ClassBase__.superClassOf\r
+ * @param klass {__ClassBase__}\r
+ * @return {boolean}\r
+ */\r
function X_Class_superClassOf( klass ){\r
var myDef = X_Class_getClassDef( this ),\r
targetDef = X_Class_getClassDef( klass ),\r
return false;\r
};\r
\r
+/**\r
+ * サブクラスか?調べます。\r
+ * @alias __ClassBase__.subClassOf\r
+ * @type {Function}\r
+ * @param klass {__ClassBase__}\r
+ * @return {boolean}\r
+ */\r
function X_Class_subClassOf( klass ){\r
- return X_Class_superClassOf.call( klass, this );\r
+ return klass && X_Class_superClassOf.call( klass, this );\r
};\r
- \r
-/* サブクラスを作るメソッド \r
- * var subClass = superClass.inherits( ... ) \r
- * http://d.hatena.ne.jp/m-hiyama/20051018/1129605002\r
+ \r
+/**\r
+ * サブクラスを作ります。与える引数は X.Class.create と同じです。http://d.hatena.ne.jp/m-hiyama/20051018/1129605002\r
+ * @alias __ClassBase__.inherits\r
+ * @example var SubClass = SuperClass.inherits( 'Sub', X.Class.FINAL, { ... } );\r
+ * @param {string} [displayName] クラスの名前\r
+ * @param {number} [classSetting=0] X.Class.POOL_OBJECT | X.Class.FINAL など\r
+ * @param {__ClassBase__=} [privateClass] このクラスとペアで動作するシャドウクラス\r
+ * @param {object} [props={}] このクラスのメンバと関数。コンストラクタは Constructor と書くこと\r
+ * @return {__ClassBase__}\r
*/\r
function X_Class_inherits( /* displayName, classSetting, opt_PrivateClass, props */ ){\r
var args = X_Object_cloneArray( arguments ),\r
classSetting = superDef.setting;// &= ~X.Class.ABSTRACT;\r
};\r
if( superDef.isPrivate ) classSetting = classSetting | X.Class.PRIVATE_DATA;\r
- //opt_super = !!( classSetting & X.Class.SUPER_ACCESS );\r
+\r
params.push( classSetting );\r
\r
// サブクラスのシャドウ\r
});\r
\r
// 内部イベント\r
-X_TEMP.SYSTEM_EVENT_PRE_INIT = 1;\r
-X_TEMP.SYSTEM_EVENT_XTREE = 2;\r
-X_TEMP.SYSTEM_EVENT_INIT = 3;\r
+X_TEMP.SYSTEM_EVENT_PRE_INIT = 5; // X_Listeners_.KILL_RESERVED に +1 した値から開始。\r
+X_TEMP.SYSTEM_EVENT_XTREE = 6;\r
+X_TEMP.SYSTEM_EVENT_INIT = 7;\r
\r
+/**\r
+ * フレームワーク内で定義されたイベント。\r
+ * @namespace X.Event\r
+ * @alias X.Event\r
+ */\r
X.Event = {\r
- XDOM_READY : 4,\r
+ XDOM_READY : 8,\r
\r
- COMPLETE : 5,\r
- READY : 6,\r
- SUCCESS : 7,\r
- ERROR : 8,\r
- PROGRESS : 9,\r
- BEFORE_CANCEL : 10,\r
- CANCELED : 11,\r
- TIMEOUT : 12,\r
+ COMPLETE : 9,\r
+ READY : 10,\r
+ SUCCESS : 11,\r
+ ERROR : 12,\r
+ PROGRESS : 13,\r
+ BEFORE_CANCEL : 14,\r
+ CANCELED : 15,\r
+ TIMEOUT : 16,\r
\r
- BEFORE_KILL_INSTANCE : 13,\r
- KILL_INSTANCE_CANCELED : 14, \r
- KILL_INSTANCE : 15,\r
+ BEFORE_KILL_INSTANCE : 17,\r
+ KILL_INSTANCE_CANCELED : 18,\r
+ KILL_INSTANCE : 19,\r
\r
- VIEW_ACTIVATE : 16,\r
- VIEW_DEACTIVATE : 17,\r
- VIEW_RESIZED : 18,\r
- VIEW_TURNED : 19,\r
- BASE_FONT_RESIZED : 20,\r
+ VIEW_ACTIVATE : 20,\r
+ VIEW_DEACTIVATE : 21,\r
+ VIEW_RESIZED : 22,\r
+ VIEW_TURNED : 23,\r
+ BASE_FONT_RESIZED : 24,\r
// in_page_jump\r
// on_screen_keyboard_show\r
// on_screen_keyboard_hide\r
- BEFORE_UPDATE : 21,// X_System このイベントで要素のサイズを取得すると無限ループに!\r
- UPDATED : 22,// X_System\r
- AFTER_UPDATE : 23,\r
+ BEFORE_UPDATE : 25,// X_System このイベントで要素のサイズを取得すると無限ループに!\r
+ UPDATED : 26,// X_System\r
+ AFTER_UPDATE : 27,\r
\r
- HASH_CHANGED : 24,\r
+ HASH_CHANGED : 28,\r
\r
- BEFORE_UNLOAD : 25,\r
- UNLOAD : 26,\r
+ BEFORE_UNLOAD : 29,\r
+ UNLOAD : 30,\r
\r
- BACKEND_READY : 27,\r
- BACKEND_NONE : 28,\r
- BACKEND_RESEARCH : 29,\r
- BACKEND_CHANGED : 30,\r
+ BACKEND_READY : 31,\r
+ BACKEND_NONE : 32,\r
+ BACKEND_RESEARCH : 33,\r
+ BACKEND_CHANGED : 34,\r
\r
- ANIME_BEFORE_START : 31,\r
- ANIME_START : 32,\r
- ANIME : 33,\r
- ANIME_END : 34,\r
- ANIME_BEFORE_STOP : 35, // xnode.stop() のみ、指定時間による停止では呼ばれない\r
- ANIME_STOP : 36,\r
+ ANIME_BEFORE_START : 35,\r
+ ANIME_START : 36,\r
+ ANIME : 37,\r
+ ANIME_END : 38,\r
+ ANIME_BEFORE_STOP : 39, // xnode.stop() のみ、指定時間による停止では呼ばれない\r
+ ANIME_STOP : 40,\r
\r
- GPU_RELEASED : 37,\r
+ GPU_RELEASED : 41,\r
\r
- MEDIA_PLAYING : 38,\r
- MEDIA_BEFORE_LOOP : 39, // cancelable\r
- MEDIA_LOOPED : 40,\r
- MEDIA_PAUSED : 41,\r
- MEDIA_ENDED : 42,\r
- MEDIA_WAITING : 43,\r
- MEDIA_SEEKING : 44\r
+ MEDIA_PLAYING : 42,\r
+ MEDIA_BEFORE_LOOP : 43, // cancelable\r
+ MEDIA_LOOPED : 44,\r
+ MEDIA_PAUSED : 45,\r
+ MEDIA_ENDED : 46,\r
+ MEDIA_WAITING : 47,\r
+ MEDIA_SEEKING : 48\r
};\r
\r
-X_Event_last = 44;\r
+X_Event_last = 48;\r
\r
X_TEMP.onSystemReady.push(\r
function(){\r
-/**\r
- * \r
- */\r
-\r
-/**\r
- * X.EventDispatcher\r
- * \r
- * 1. as3 の EventDispatcher ライクなクラス。そのまま使ったり、継承したり。コールバック中にイベントを追加したら?削除したら?にも対処している。\r
- * 2. _rawObject メンバがいる場合、addEventListener, attachEvent, on 等で生のブラウザオブジェクトにリスナを登録する。\r
- * window, document, HTMLElement, Image, XHR などが _rawObject\r
- * \r
- * use X.Callback\r
+/*\r
+ * <p>EventDispatcher インスタンスのメンバ(_listeners)でイベントリスナをイベント名(string)やイベントID(5~以上の number, フレームワーク内で定義、5 以上になる理由は後述)をキーとする Array で記憶します。\r
+ * Arrayには、__CallbackHash__ というハッシュ、または関数が蓄えられています。\r
* \r
- * https://developer.mozilla.org/ja/docs/Web/API/EventTarget.addEventListener\r
- * イベント発送中のリスナーの追加\r
- * EventListener がイベント処理中に EventTarget に追加された場合、それが現在のアクションによって実行されることはありませんが、浮上フェーズのように、後の段階のイベントフローで実行されるかもしれません。\r
+ * また、dispatch 中の状態と操作を記録し不整合が起きないようにするためのプロパティを持ち、0 から 4 の番号が与えられています。\r
* \r
- * https://developer.mozilla.org/ja/docs/Web/API/EventTarget.removeEventListener\r
- * イベントリスナーが イベントを処理中であるイベントターゲットから削除された場合、現在のアクションによってそのイベントリスナーが実行されることはありません。\r
- * イベントリスナーは、決して削除された後に実行されることはありません。\r
- * イベントターゲット上にある現在のどのイベントリスナーも指定していない引数付きの removeEventListener は、何の効果もありません。\r
+ * <dl>\r
+ * <dt>0:ACTUAL_HANDLER\r
+ * <dd>イベントターゲットの addEventListener 等に渡される実際の関数(再利用可能クロージャ)を控えています。\r
+ * <dt>1:DISPATCHING number\r
+ * <dd>イベントディスパッチ中か?またディスパッチがネストした場合、その深さを記憶します。\r
+ * <dt>2:RESERVES Array\r
+ * <dd>イベント発火中に listen() が呼ばれた場合に引数を蓄え、全てのディスパッチの完了時(_dispatching===0)に再度 listen() するための一時ストアです。\r
+ * <dt>3:UNLISTENS Array\r
+ * <dd>イベント発火中に unlisten() が呼ばれた場合に対象リスナを記憶し、リスナが呼ばれないようにします。全てのディスパッチの完了時(_dispatching===0)に再度 unlisten() します。\r
+ * <dt>4:KILL_RESERVED boolean\r
+ * <dd>イベント発火中に kill() が呼ばれた場合に、全てのディスパッチの完了時(_dispatching===0)に再度 kill() するためのフラグです。\r
+ * </dl>\r
*/\r
+var X_Listeners,\r
+\r
+ /** @enum {number} */\r
+ X_Listeners_ = {\r
+ ACTUAL_HANDLER : 0,\r
+ DISPATCHING : 1,\r
+ RESERVES : 2,\r
+ UNLISTENS : 3,\r
+ KILL_RESERVED : 4 // X.Event で、イベントIDを 5 から始めているので注意。\r
+ };\r
+\r
+\r
\r
// ------------------------------------------------------------------------- //\r
// ------------ local variables -------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
+\r
var X_EventDispatcher_once = false,\r
X_EventDispatcher_lock = false,\r
X_EventDispatcher_unlock = false,\r
},\r
\r
X_EventDispatcher_LAZY_TIMERS = {}; // Object.<number, X.EventDispatcher> number は timerID\r
- \r
-/*\r
- * イベントリスナをイベント名(string)や数値(1~,フレームワーク内で定義)をキーとするArrayで記憶します。\r
- * Arrayには、{k:種類,x:コンテキスト(thisObject),f:関数,s:サプリメントする引数の配列} というハッシュ、または関数が蓄えられています。\r
- * また、dispatch 中の状態と操作を記録し不整合が起きないようにするためのプロパティを持ちます。\r
- * @typedef {(\r
- * {\r
- * _handleEvent : function,\r
- * _dispatching : number,\r
- * _reserves : (Array|undefined),\r
- * _unlistens : {Object.<(number|string), Array.<(X.Callback|function)>>},\r
- * _killReserved : (Boolean|undefiend)\r
- * }\r
- * |\r
- * Object.<(number|string), Array.<(callbackHash|function)>>\r
- * )}\r
- */\r
-var X_EventDispatcher_listeners;\r
\r
// ------------------------------------------------------------------------- //\r
// --- interface ----------------------------------------------------------- //\r
// ------------------------------------------------------------------------- //\r
\r
/**\r
- * <p>イベントターゲット(widnow, document, Image, XHR, Silverlight 等)をラップする場合、通常は new 時に渡します。\r
- * <p>参照:コンストラクタ実体 {@link X.EventDispatcher.Constructor}\r
- * <p>アプリケーション独自のイベントをやり取りしたい、という場合、イベントターゲットは不要です。\r
+ * <ol>\r
+ * <li>as3 の EventDispatcher ライクなクラス。そのまま使ったり、継承したり。\r
+ * <li>_rawObject メンバがいる場合、addEventListener, attachEvent, on 等で生のブラウザオブジェクトにリスナを登録する。\r
+ * window, document, HTMLElement, Image, XHR, Silverlight などが _rawObject\r
+ * <li>イベントディスパッチにリスナの追加が呼び出された場合、リスナはこれ以降のイベントから呼ばれます。同様にリスナの削除が呼ばれた場合、そのリスナが呼ばれることはありません。\r
+ * </ol>\r
+ * \r
+ * <blockquot>\r
+ * <p><a href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget.addEventListener" target="_blank">\r
+ * MDN > 開発者向けのWeb技術 > Web API インターフェイス > EventTarget > EventTarget.addEventListener イベント発送中のリスナーの追加</a>\r
+ * <p>EventListener がイベント処理中に EventTarget に追加された場合、それが現在のアクションによって実行されることはありませんが、浮上フェーズのように、後の段階のイベントフローで実行されるかもしれません。\r
+ * </blockquot>\r
+ * \r
+ * <blockquot>\r
+ * <p><a href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget.removeEventListener" target="_blank">\r
+ * MDN > 開発者向けのWeb技術 > Web API インターフェイス > EventTarget > EventTarget.removeEventListener 注記</a>\r
+ * <p>イベントリスナーが イベントを処理中であるイベントターゲットから削除された場合、現在のアクションによってそのイベントリスナーが実行されることはありません。\r
+ * <p>イベントリスナーは、決して削除された後に実行されることはありません。\r
+ * <p>イベントターゲット上にある現在のどのイベントリスナーも指定していない引数付きの removeEventListener は、何の効果もありません。\r
+ * </blockquot>\r
+ *\r
+ * <p>listen, unlisten, dispatch という addEventListener, removeEventListener, dispatchEvent に対応する関数を持ちます。\r
+ * また listening という ActionScript3 の hasEventListener に相当する関数を持ちます。\r
+ * \r
+ * <p>イベントターゲットオブジェクト(widnow, document, HTMLElement, XHR, Silverlight 等)が this._rawObject に設定されていた場合に、それらへ実際のイベント登録・解除も行います。\r
+ * このイベントの登録・解除はクロスブラウザで、IE5~8 の独自イベントの差異を吸収し、DOM0 に対しても複数のコールバックを登録することができます。\r
+ * \r
+ * <p>またコールバックに対して、this コンテキストや、追加の引数を指定もできます。 this コンテキストを指定しなかった場合、EventDispatcher インスタンスがコールバックの this になります。 \r
* \r
- * @class\r
- * @classdesc EventTarget オブジェクトをラップしたり、アプリケーションで独自に定義したイベントを発信するためのクラスです。\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
+ * <p>unlisten() は、引数を指定しなかった場合、全てのイベントを解除します。ただし、systemListen 経由で登録されたハンドラは解除されません。\r
* \r
- * @augments X_Class_CommonProps\r
+ * systemListen, systemUnlisten は、ライブラリ内のコードからしかアクセスできません。\r
* \r
- * @param {object=} opt_rawObject イベントターゲット(EventTarget)\r
+ * @alias X.EventDispatcher\r
+ * @class EventDispatcher オブジェクトをラップしたり、アプリケーションで独自に定義したイベントを発信するためのクラスです。\r
+ * @constructor \r
+ * @constructs EventDispatcher\r
+ * @extends {__ClassBase__}\r
*/\r
-X.EventDispatcher =\r
+var EventDispatcher = X.EventDispatcher =\r
X.Class.create(\r
'EventDispatcher',\r
\r
- /** @lends X.EventDispatcher.prototype */\r
+ /** @lends EventDispatcher.prototype */\r
{\r
\r
/**\r
'_rawType' : X_EventDispatcher_EVENT_TARGET_TYPE.OTHER,\r
\r
/**\r
- * イベントリスナをイベント名(string)や数値(1~,フレームワーク内で定義)をキーとするArrayで記憶します。\r
+ * イベントリスナをイベント名文字列や数値(1~,フレームワーク内で定義)をキーとするArrayで記憶します。<br>\r
* Arrayには、{k:種類,x:コンテキスト(thisObject),f:関数,s:サプリメントする引数の配列} というハッシュ、または関数が蓄えられています。\r
* \r
* @private\r
- * @type {X_EventDispatcher_listeners}\r
+ * @type {X_Listeners}\r
*/\r
'_listeners' : null,\r
\r
'_rawObject' : null,\r
\r
/**\r
- * X.EventDispatcher のコンストラクタの実体。\r
- * @constructs\r
- * @this {X.EventDispatcher}\r
+ * X.EventDispatcher のコンストラクタの実体。<br>\r
+ * イベントターゲットをラップする場合、通常は new 時に渡します。<br>\r
+ * アプリケーション独自のイベントをやり取りしたいだけ、という場合イベントターゲットは指定しません。\r
* @param {object=} opt_rawObject\r
*/\r
Constructor : function( opt_rawObject ){\r
};\r
},\r
\r
- /**\r
- * 登録されたイベントリスナを呼び出す。イベントリスナの返り値(数値)を OR したものを返す。\r
- * @this {X.EventDispatcher}\r
- * @return {number}\r
- * @param {(eventHash|string|number)} e\r
- */ \r
dispatch : X_EventDispatcher_dispatch,\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
- * 一度 dispatch された時に自動で unlisten されるフラグを立てて listen する。\r
- * @this {X.EventDispatcher}\r
- * @return {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
+ * dispatch 時に自動で unlisten されるフラグを立てて listen する。\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=] コールバック時の引数を配列に入れる。引数がひとつでも配列を使用する。省略した場合引数なし。unlisten() に使用するので、配列も適宜に保持しておくこと。\r
+ * @return {EventDispatcher} チェインメソッド\r
*/\r
listenOnce : function( type, opt_arg1, opt_arg2, opt_arg3 ){\r
X_EventDispatcher_once = true;\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
- * @param {(listener|function|Array|callbackHash)=} opt_arg1\r
- * @param {(function|Array=} opt_arg2\r
- * @param {Array=} opt_arg3\r
+ * @return {number|boolean}\r
+ * @param {string|number} opt_type\r
+ * @param {listener|function|Array|callbackHash} opt_arg1\r
+ * @param {function|Array} opt_arg2\r
+ * @param {Array} opt_arg3\r
*/ \r
listening : function( opt_type, opt_arg1, opt_arg2, opt_arg3 ){\r
var listeners = this[ '_listeners' ],\r
cbHash = X_Callback_classifyCallbackArgs( opt_arg1, opt_arg2, opt_arg3, this );\r
};\r
\r
- if( ( unlistens = listeners._unlistens ) && ( unlistens = unlistens[ opt_type ] ) ){\r
+ if( ( unlistens = listeners[ X_Listeners_.UNLISTENS ] ) && ( unlistens = unlistens[ opt_type ] ) ){\r
for( i = unlistens.length; i; ){\r
f = unlistens[ --i ];\r
if( f === cbHash || ( f.x === cbHash.x && f.f === cbHash.f && f.s === cbHash.s && f.lock === lock ) ) return false;\r
\r
/**\r
* delay(ミリ秒)後にイベントを dispatch する。戻り値は uid = X.Timer.add() のタイマーID(数値)。X.Timer.remove(uid) でタイマーを解除して dispatch を中止できる。\r
- * @this {X.EventDispatcher}\r
- * @param {(number|eventHash|string)=} delay ms 省略した場合は 0 として扱う asyncDispatch( 'myevent' ) -> asyncDispatch( 0, 'myevent' )\r
- * @param {(eventHash|string|number)=} e イベントを表す数値、文字列、{ type : XXX, ... } なオブジェクト\r
+ * kill() 時には内部でまだ呼ばれていないタイマーの X.Timer.remove() が行われる。\r
+ * @example this.asyncDispatch( 'myevent' );\r
+ * // どちらのコードも同じ動作をする。\r
+ * this.asyncDispatch( 0, 'myevent' );\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
// ------------------------------------------------------------------------- //\r
\r
/**\r
- * 登録されたイベントリスナを呼び出す。イベントリスナの返り値(数値)を OR したものを返す。イベントハッシュでなく、string|number を渡すと内部でイベントハッシュを作る\r
- * @this {X.EventDispatcher}\r
+ * 登録されたイベントリスナを呼び出す。イベントリスナの返り値(数値)を OR したものを返す。イベントハッシュでなく、string|number を渡すと内部でイベントハッシュを作る。\r
+ * dispatch のコールバック中で kill() が呼ばれた場合、実際の kill は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で kill() する。__ClassBase__ も参照。\r
+ * dispatch のコールバック中で listen() が呼ばれた場合、実際の listen は、dispatch の終わりまで待機する。dispatch がネストする場合は全ての dispatch の完了で listen() する。\r
+ * dispatch のコールバック中で unlisten() が呼ばれた場合、即座に反映され削除されたイベントリスナーは呼ばれない。\r
+ * @alias EventDispatcher.prototype.dispatch\r
+ * @param {eventHash|string|number} e\r
* @return {number} X.Callback で定義された数値\r
- * @param {(eventHash|string|number)} e\r
*/\r
function X_EventDispatcher_dispatch( e ){\r
var listeners = this[ '_listeners' ],\r
e.target = e.target || this;\r
e.currentTarget = e.currentTarget || this;\r
\r
- if( listeners._dispatching ){\r
- ++listeners._dispatching;\r
+ if( listeners[ X_Listeners_.DISPATCHING ] ){\r
+ ++listeners[ X_Listeners_.DISPATCHING ];\r
} else {\r
- listeners._dispatching = 1;\r
+ listeners[ X_Listeners_.DISPATCHING ] = 1;\r
};\r
\r
// todo:\r
// type も保存\r
- listeners._unlistens = listeners._unlistens || {};\r
- unlistens = listeners._unlistens[ type ];\r
+ listeners[ X_Listeners_.UNLISTENS ] = listeners[ X_Listeners_.UNLISTENS ] || {};\r
+ unlistens = listeners[ X_Listeners_.UNLISTENS ][ type ];\r
\r
for( i = 0; i < list.length; ++i ){\r
f = list[ i ];\r
if( !unlistens ){\r
- unlistens = listeners._unlistens[ type ];\r
+ unlistens = listeners[ X_Listeners_.UNLISTENS ][ type ];\r
};\r
if( unlistens && unlistens.indexOf( f ) !== -1 ) continue;\r
\r
- //if( f !== X.emptyFunction ){\r
- // if( f.k ){\r
- r = X_Callback_proxyCallback( f, args || ( args = [ e ] ) );\r
- // } else {\r
- // r = f.call( this, e );\r
- // };\r
- //};\r
+ r = X_Callback_proxyCallback( f, args || ( args = [ e ] ) );\r
\r
if( f.once || r & X_Callback_UN_LISTEN ){\r
// dispatch 中に unlisten が作られることがある\r
if( !unlistens ){\r
- unlistens = listeners._unlistens || ( listeners._unlistens = {} );\r
+ unlistens = listeners[ X_Listeners_.UNLISTENS ] || ( listeners[ X_Listeners_.UNLISTENS ] = {} );\r
unlistens = unlistens[ type ] || ( unlistens[ type ] = [] );\r
};\r
unlistens.indexOf( f ) === -1 && ( unlistens[ unlistens.length ] = f );\r
ret |= X.Type.isFinite( r ) ? r : 0;\r
};\r
\r
- if( ( --listeners._dispatching ) === 0 ){\r
+ if( ( --listeners[ X_Listeners_.DISPATCHING ] ) === 0 ){\r
\r
- delete listeners._dispatching;\r
+ delete listeners[ X_Listeners_.DISPATCHING ];\r
\r
// dispatch 中に listen されたイベントの追加\r
- if( list = listeners._reserves ){\r
+ if( list = listeners[ X_Listeners_.RESERVES ] ){\r
for( i = 0, l = list.length; i < l; ++i ){\r
f = list[ i ];\r
X_EventDispatcher_once = f[ 4 ];\r
f.length = 0;\r
};\r
list.length = 0;\r
- delete listeners._reserves;\r
+ delete listeners[ X_Listeners_.RESERVES ];\r
}; \r
\r
// dispatch 中に unlisten されたイベントの削除\r
- if( unlistens = listeners._unlistens ){\r
- delete listeners._unlistens;\r
+ if( unlistens = listeners[ X_Listeners_.UNLISTENS ] ){\r
+ delete listeners[ X_Listeners_.UNLISTENS ];\r
\r
// _unlistens に入っている callbackHash は、lock をクリアしている\r
X_EventDispatcher_unlock = true;\r
list.length = 0;\r
delete unlistens[ type ];\r
};\r
- X_EventDispatcher_unlock = false; \r
+ X_EventDispatcher_unlock = false;\r
};\r
\r
if( X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ] === this ){\r
delete X_EventDispatcher_LAZY_TIMERS[ X_Timer_currentUID ];\r
};\r
\r
- if( listeners._killReserved ){\r
+ if( listeners[ X_Listeners_.KILL_RESERVED ] ){\r
+ /*\r
for( timerID in X_EventDispatcher_LAZY_TIMERS ){\r
if( X_EventDispatcher_LAZY_TIMERS[ timerID ] === this ) return ret;\r
- }; \r
+ }; */\r
this.kill();\r
};\r
};\r
};\r
\r
/**\r
+ * イベントリスナを追加する。同一イベントに対して重複するリスナ(context, function, 引数 array が一致)の追加は無視される。\r
+ * ユーザーが触ることは無いが、システム内部でロックフラグを立てたリスナは、立てられていないフラグとは区別される。\r
+ * この仕組みによってシステムの登録したリスナを、システム外から不用意に削除されることを回避する。\r
+ * @example // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数を渡す。\r
+ * this.listen( 'myEvent', context, func );\r
+ * // 'myEvent' に対して、 this コンテキストを指定して 、コールバック関数と追加の引数を渡す。\r
+ * args = [ 'arg1', 'arg2', 3 ]; // unlisten( 'myEvent', context, func, args ) で使用するので Array も控えておく。\r
+ * this.listen( 'myEvent', context, func, args );\r
+ * // 'myEvent' に対して、 listener オブジェクトを渡す。listener は handleEvent という関数を持つオブジェクトのこと。\r
+ * listener.handleEvent = function( e ){};\r
+ * this.listen( 'myEvent', listener );\r
+ * // 'myEvent' に対して、 listener オブジェクトと追加の引数を渡す。\r
+ * listener.handleEvent = function( e, arg1, arg2, arg3 ){};\r
+ * this.listen( 'myEvent', listener, [ arg1, arg2, arg3 ] );\r
+ * // 'myEvent' に対して、 function を渡す。\r
+ * this.listen( 'myEvent', onMyEvent );\r
+ * // 'myEvent' に対して、 function と追加の引数を渡す。\r
+ * this.listen( 'myEvent', onMyEvent, args );\r
+ * // 次の二つは同じ動作です。 this コンテキストが与えられなかった場合、コールバックの this は発火元インスタンスになります。\r
+ * this.listen( 'myEvent', this [, func [, args ] ] );\r
+ * this.listen( 'myEvent' [, func [, args ] ] );\r
+ * // 複数のイベントタイプを同時に登録。コールバックは同じ指定が使われる。\r
+ * this.listen( [ 'open', 'close', 'ready' ], onUpdate );\r
* \r
- * @this {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
+ * @alias EventDispatcher.prototype.listen\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 {EventDispatcher} チェインメソッド\r
*/\r
function X_EventDispatcher_listen( type, opt_arg1, opt_arg2, opt_arg3 ){\r
var listeners = this[ '_listeners' ],\r
\r
if( !type ) return this;\r
\r
- if( listeners && listeners._dispatching ){\r
- if( !listeners._reserves ) listeners._reserves = [];\r
- listeners._reserves[ listeners._reserves.length ] = [ type, opt_arg1, opt_arg2, opt_arg3, X_EventDispatcher_once, X_EventDispatcher_lock ];\r
+ if( listeners && listeners[ X_Listeners_.DISPATCHING ] ){\r
+ if( !listeners[ X_Listeners_.RESERVES ] ) listeners[ X_Listeners_.RESERVES ] = [];\r
+ listeners[ X_Listeners_.RESERVES ][ listeners[ X_Listeners_.RESERVES ].length ] = [ type, opt_arg1, opt_arg2, opt_arg3, X_EventDispatcher_once, X_EventDispatcher_lock ];\r
return this;\r
};\r
\r
// TODO this.listen(type) は this リスナの登録なのに、this.unlisten(type)は全てのtypeの削除、と不一致\r
\r
/**\r
- * \r
- * @this {X.EventDispatcher}\r
- * @return {X.EventDispatcher}\r
- * @param {(string|number|Array.<(string,number)>)=} opt_type\r
- * @param {(listener|function|Array)=} opt_arg1\r
- * @param {(function|Array=} opt_arg2\r
- * @param {Array=} opt_arg3\r
+ * イベントリスナの解除を行う。登録時と同じ引数を与える必要がある。kill() ですべてのイベントが解除されるので、途中で解除されるイベント以外は kill() に任せてしまってよい。\r
+ * @alias EventDispatcher.prototype.unlisten\r
+ * @return {EventDispatcher}\r
+ * @param {string|number|Array.<string,number>} opt_type\r
+ * @param {listener|function|Array} opt_arg1\r
+ * @param {function|Array} opt_arg2\r
+ * @param {Array} opt_arg3\r
*/\r
function X_EventDispatcher_unlisten( opt_type, opt_arg1, opt_arg2, opt_arg3 ){\r
var listeners = this[ '_listeners' ],\r
// 全て削除\r
for( opt_type in listeners ){\r
//if( X_EMPTY_OBJECT[ opt_type ] ) continue;\r
- if( opt_type.charAt( 0 ) === '_' ) continue;\r
+ if( opt_type < X_Listeners_.KILL_RESERVED ) continue;\r
list = listeners[ opt_type ];\r
for( i = list.length; i; ){\r
this.unlisten( opt_type, list[ --i ] ); // override されていることがあるので、必ず unlisten を使用\r
};\r
return this;\r
} else\r
- if( reserves = listeners._reserves ){\r
+ if( reserves = listeners[ X_Listeners_.RESERVES ] ){\r
for( i = reserves.length; i; ){\r
f = reserves[ --i ];\r
if( f[ 0 ] === opt_type && f[ 1 ] === opt_arg1 && f[ 2 ] === opt_arg2 && f[ 3 ] === opt_arg3 && ( !f[ 5 ] || X_EventDispatcher_unlock ) ){\r
reserves.splice( i, 1 );\r
- if( !reserves.legth ) delete listeners._reserves;\r
+ if( !reserves.legth ) delete listeners[ X_Listeners_.RESERVES ];\r
return this;\r
};\r
};\r
\r
f = ( list = listeners[ opt_type ] )[ i ];\r
\r
- if( unlistens = listeners._unlistens ){\r
+ if( unlistens = listeners[ X_Listeners_.UNLISTENS ] ){\r
// _unlistens に入っている callbackHash は、lock のチェックは済んでいる\r
( unlistens = unlistens[ opt_type ] ) ?\r
( unlistens[ unlistens.length ] = f ) :\r
- ( listeners._unlistens[ opt_type ] = [ f ] );\r
+ ( listeners[ X_Listeners_.UNLISTENS ][ opt_type ] = [ f ] );\r
} else {\r
delete f.once;\r
list.splice( i, 1 );\r
// TODO カウンター\r
empty = true;\r
for( k in listeners ){\r
- if( k.charAt( 0 ) === '_' ) continue;\r
+ if( k < X_Listeners_.KILL_RESERVED ) continue;\r
empty = false;\r
break;\r
};\r
- if( raw && '' + parseFloat( opt_type ) !== '' + opt_type ){ // 数字イベントの除外\r
+ if( raw && !X_String_isNumberString( opt_type ) ){ // 数字イベントの除外\r
X_EventDispatcher_removeEvent( this, opt_type, raw, list, !empty );\r
};\r
if( empty ) delete this[ '_listeners' ];\r
type === 'animationiteration' || type === 'webkitAnimationIteration' ) ){\r
raw.addEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
} else {\r
- f = that[ '_listeners' ]._handleEvent || ( that[ '_listeners' ]._handleEvent = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
+ f = that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
\r
if( raw.addEventListener ){\r
raw.addEventListener( type, f, false );\r
break;\r
\r
default :\r
- f = that[ '_listeners' ]._handleEvent || ( that[ '_listeners' ]._handleEvent = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
+ f = that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
\r
if( raw.attachEvent ){\r
raw.attachEvent( 'on' + type, f );\r
break;\r
\r
default :\r
- raw[ 'on' + type ] = that[ '_listeners' ]._handleEvent || ( that[ '_listeners' ]._handleEvent = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
+ raw[ 'on' + type ] = that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] || ( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] = X_Callback_create( that, X_EventDispatcher_actualHandleEvent ) );\r
break;\r
};\r
});\r
\r
/*\r
* iOS の webkitTransitionEnd が連続して起こる場合、\r
- * コールバックの(that._handleEvent)クロージャ内の実際のコールバック(X_Callback_actualClosure:obj._)が\r
+ * コールバックの(that[ X_Listeners_.ACTUAL_HANDLER ])クロージャ内の実際のコールバック(X_Callback_actualClosure:obj._)が\r
* 参照できていない問題に遭遇、、、iOS3.1.3 & iOS6.1.5 で確認\r
* animation も怪しい、、、\r
*/\r
raw.removeEventListener( type, X_EventDispatcher_iOSTransitionEndDispatch, false );\r
} else \r
if( raw.addEventListener ){\r
- raw.removeEventListener( type, that[ '_listeners' ]._handleEvent, false );\r
+ raw.removeEventListener( type, that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ], false );\r
} else {\r
raw[ 'on' + type ] = null;\r
};\r
\r
- if( !skip && that[ '_listeners' ]._handleEvent ){\r
- X_Callback_correct( that[ '_listeners' ]._handleEvent );\r
- delete that[ '_listeners' ]._handleEvent;\r
+ if( !skip && that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] ){\r
+ X_Callback_correct( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] );\r
+ delete that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ];\r
};\r
};\r
}) :\r
\r
default :\r
if( raw.attachEvent ){\r
- raw.detachEvent( 'on' + type, that[ '_listeners' ]._handleEvent );\r
+ raw.detachEvent( 'on' + type, that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] );\r
} else {\r
raw[ 'on' + type ] = X.emptyFunction;\r
raw[ 'on' + type ] = '';\r
};\r
\r
if( !skip ){\r
- X_Callback_correct( that[ '_listeners' ]._handleEvent );\r
- delete that[ '_listeners' ]._handleEvent;\r
+ X_Callback_correct( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] );\r
+ delete that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ];\r
};\r
};\r
}) :\r
raw[ 'on' + type ] = '';\r
\r
if( !skip ){\r
- X_Callback_correct( that[ '_listeners' ]._handleEvent );\r
- delete that[ '_listeners' ]._handleEvent;\r
+ X_Callback_correct( that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ] );\r
+ delete that[ '_listeners' ][ X_Listeners_.ACTUAL_HANDLER ];\r
};\r
};\r
});\r
\r
\r
+// TODO ブラウザからの呼び出しの最後に登録された関数を呼び出す機能(例えば画面の更新)\r
+\r
// handleEvent を拡張可能にするために、クロージャに移動した\r
// Is this in regard to the Safari 1.x preventDefault bug on click/dblclick?\r
// https://groups.google.com/forum/#!msg/comp.lang.javascript/uYEuCHjHxnw/yKoHtZJPa1QJ\r
return event.returnValue = false;\r
};\r
}) :\r
- //X_UA_EVENT.W3C & X_UA_EVENT.DOM0\r
+ //X_UA_EVENT.W3C || X_UA_EVENT.DOM0\r
(function( e ){\r
var ev = new X.Dom.Event( e, this ),\r
ret = X_Callback_NONE,\r
ret = X.Callback.STOP_PROPAGATION | X.Callback.PREVENT_DEFAULT;\r
} else {\r
for( i = 0, l = ev.length; i < l; ++i ){\r
- console.log( 'handleEvent ' + ev[ i ].type );\r
+ //console.log( 'handleEvent ' + ev[ i ].type );\r
ret |= this.dispatch( ev[ i ] ) || 0;\r
}; \r
};\r
function X_EventDispatcher_toggleAllEvents( that, add ){\r
var list = that[ '_listeners' ],\r
raw = that._rawObject || X_UA_DOM.IE4 && X_Node__ie4getRawNode( that ),\r
- f = add ? X_EventDispatcher_addEvent : X_EventDispatcher_removeEvent,\r
+ func = add ? X_EventDispatcher_addEvent : X_EventDispatcher_removeEvent,\r
type;\r
if( !list || !raw ) return;\r
for( type in list ){\r
//if( X_EMPTY_OBJECT[ type ] ) continue;\r
- if( type.charAt( 0 ) === '_' ) continue;\r
+ //if( type < X_Listeners_.KILL_RESERVED ) continue;\r
// 数字イベントの除外\r
- if( '' + parseFloat( type ) !== type ){\r
+ if( !X_String_isNumberString( type ) ){\r
// TODO type rename はここ\r
- f( that, type, raw, list[ type ], true );\r
+ func( that, type, raw, list[ type ], true );\r
};\r
};\r
};\r
if( X_EventDispatcher_LAZY_TIMERS[ uid ] ){\r
eventDispatcher = X_EventDispatcher_LAZY_TIMERS[ uid ];\r
delete X_EventDispatcher_LAZY_TIMERS[ uid ];\r
- \r
+ /*\r
listeners = eventDispatcher[ '_listeners' ];\r
- if( listeners && !listeners._dispatching && listeners._killReserved ){\r
+ if( listeners && !listeners[ X_Listeners_.DISPATCHING ] && listeners[ X_Listeners_.KILL_RESERVED ] ){\r
for( uid in X_EventDispatcher_LAZY_TIMERS ){\r
if( X_EventDispatcher_LAZY_TIMERS[ uid ] === eventDispatcher ){\r
lazy = true;\r
};\r
}; \r
!lazy && eventDispatcher.kill();\r
- };\r
+ }; */\r
};\r
\r
!X_Timer_skipUpdate && ( q.last <= X_Timer_waitTime || l === 1 ) && X_Timer_update();\r
GPU_RESERVED : 2 << 21, // 2:GPU予約\r
GPU_NOW : 2 << 22, // 3:GPU now!\r
GPU_RELEASE_RESERVED : 2 << 23, // 4:GPU解除予約\r
+ GPU_CHILD : 2 << 24, \r
\r
IE4_HAS_TEXTNODE : X_UA.IE4 ? 2 << 21 : 0,\r
IE4_HAS_ELEMENT : X_UA.IE4 ? 2 << 22 : 0,\r
length : 1,\r
parent : null, // remove された枝も親子構造は維持している。\r
_xnodes : null, // Array.<Node>\r
+ _gpuParent : null,\r
\r
_tag : '',\r
_text : '',\r
};\r
};\r
\r
+function X_Node_toggleInGPUFlag( gpuRoot, xnodes, flag ){\r
+ var i = xnodes.length, xnode;\r
+\r
+ if( flag ){\r
+ for( ; i; ){\r
+ xnode = xnodes[ --i ];\r
+ if( !xnode._gpuParent ){\r
+ xnode._flags |= X_Node_State.GPU_CHILD;\r
+ xnode._gpuParent = gpuRoot;\r
+ xnode._xnodes && X_Node_toggleInTreeFlag( gpuRoot, xnode._xnodes, flag ); \r
+ };\r
+ };\r
+ } else {\r
+ for( ; i; ){\r
+ xnode = xnodes[ --i ];\r
+ if( xnode._gpuParent === gpuRoot ){\r
+ xnode._flags &= ~X_Node_State.GPU_CHILD;\r
+ delete xnode._gpuParent;\r
+ xnode._xnodes && X_Node_toggleInTreeFlag( gpuRoot, xnode._xnodes, flag );\r
+ };\r
+ };\r
+ };\r
+};\r
+\r
/* --------------------------------------\r
* Create\r
*/\r
function X_Node_destroy( isChild ){\r
var xnodes = this._xnodes, i, elm;\r
\r
- if( !this._flags ) return;\r
+ if( ( this._flags & X_Node_State.EXIST ) === 0 ) return;\r
\r
elm = this._rawObject || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
\r
\r
if( this._flags & X_Node_State.IN_TREE ){\r
!isChild && this.remove();\r
- delete this._flags;\r
+ this._flags &= ~X_Node_State.EXIST;\r
} else {\r
this.parent && this.parent._xnodes.splice( this.parent._xnodes.indexOf( this ), 1 );\r
elm && !isChild && X_Node__actualRemove( this );\r
function X_Node_onBeforeKill( e ){\r
var xnodes = this._xnodes, i, elm;\r
\r
- if( !this._flags ) return X.Callback.NONE;\r
+ if( ( this._flags & X_Node_State.EXIST ) === 0 ) return X.Callback.NONE;\r
\r
elm = this._rawObject || X_UA_DOM.IE4 && X_Node__ie4getRawNode( this );\r
elm && this._listeners && this.unlisten(); // イベントの退避\r
if( e ){\r
this.remove();\r
if( X_Node_reserveRemoval[ X_Node_reserveRemoval.length - 1 ] === this ){\r
- delete this._flags;\r
+ this._flags &= ~X_Node_State.EXIST;\r
return X.Callback.PREVENT_DEFAULT; \r
}; \r
};\r
};\r
return this;\r
};\r
- if( !text ) return this.empty();\r
if( ( xnodes = this._xnodes ) && xnodes.length === 1 && !xnodes[ 0 ]._tag ){\r
xnodes[ 0 ].text( text );\r
return this;\r
};\r
+ // TODO 一つのtextnode を残すケース 完全に削除したい場合は empty()を使う\r
+ if( !text ) return this.empty(); \r
this.empty().createText( text );\r
return this;\r
};\r
xnode = removal[ --i ];\r
// TODO GPU レイヤーの子の場合、remove をスキップする。 非GPU レイヤーへ apppend される場合、clone する?\r
X_Node__actualRemove( xnode );\r
- !xnode._flags && xnode.kill();\r
+ ( xnode._flags & X_Node_State.EXIST ) === 0 && xnode.kill();\r
};\r
removal.length = 0;\r
};\r
\r
if( X_Node_documentFragment ){\r
//( frg = X_Node_documentFragment ).appendChild( elm );\r
+ // 連続する要素の差し替えの場合に有効\r
};\r
\r
if( X_Node_strictElmCreation ){\r
that._flags &= X_Node_BitMask_RESET_DIRTY;\r
// ie の string から要素を作る場合、ネットワーク系属性は onload イベントなどを拾うために、要素生成->イベント復帰後に適用する\r
- that._newAttrs && ( that._flags |= X_Node_State.DIRTY_ATTR ); // Network 系の属性は遅らせて設定\r
+ that._newAttrs && ( that._flags |= X_Node_State.DIRTY_ATTR ); // _newAttrs には ネットワーク系属性が入っている。Network 系の属性は遅らせて設定\r
that._flags |= X_Node_State.DIRTY_IE_FILTER;// doc 追加後に filter を指定しないと有効にならない。\r
} else {\r
elm.UID = that._uid;\r
X_Node__afterActualCreate( xnodes[ --i ] );\r
};\r
};\r
- // ã\83\8dã\83\83ã\83\88ã\82\8fã\83¼ã\81\86系属性と filter は要素生成後に適用\r
+ // ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯系属性と filter は要素生成後に適用\r
if( that._flags & ( X_Node_State.DIRTY_ATTR | X_Node_State.DIRTY_IE_FILTER ) ){\r
X_Node__updateRawNode( that, that._rawObject || X_Node__ie4getRawNode( that ) );\r
} else {\r
},\r
\r
// TODO chashe\r
- // TODO iframe useful or not.\r
+ // TODO iframe useful or not. TODO dynamicIframe\r
// TODO file: では http: は使えない\r
jsonp : function( url, useIframe ){\r
return new X_NET_Queue( X_NET_TYPE_JSONP, url );\r
basic 認証のかかったhtml を表示して、そのjsが xhr をすると Android1.6 では 401 error が返る。Android 2.3 では解決している。\r
Android1.6- の XHR で 401 エラーが返った場合は、iframe に xml を表示させてその内容を取ればサーバ側の対応無しでいけるかも?\r
*/\r
-var X_Net_XHR_W3C = ( !X_UA.IE7 || !X_URL_IS_LOCAL ) && window[ 'XMLHttpRequest' ] && new XMLHttpRequest(),\r
+var // Opera7.6+, Safari1.2+, khtml3.?+, Gecko0.9.7+\r
+ // ie7 ではローカルリソースには ActiveX の XHR を使う\r
+ X_Net_XHR_W3C = ( !X_UA.IE7 || !X_URL_IS_LOCAL ) && window[ 'XMLHttpRequest' ] && new XMLHttpRequest(),\r
+ \r
X_Net_XHR_X_DOMAIN = window[ 'XDomainRequest' ] && new XDomainRequest(),\r
X_Net_XHR_VERSION = 0,\r
X_Net_XHR_ACTIVE_X = !X_UA.IE4 && X_UA.IE < 8 && X_UA.ActiveX && ( new Function( [\r
};\r
\r
X.Net.XHR = {\r
- // Opera7.6+, Safari1.2+, khtml3.?+, Gecko0.9.7+\r
- W3C : !!X_Net_XHR_W3C,\r
-\r
- X_DOMAIN : !!X_Net_XHR_X_DOMAIN,\r
- \r
- // ie7 ではローカルリソースには ActiveX の XHR を使う\r
- ACTIVE_X : !!X_Net_XHR_ACTIVE_X,\r
\r
/*\r
* http://hakuhin.jp/as/import.html\r
// Progress Events Chrome7, firefox3.5, ie10, opera12, Safari?, Chrome for Android 0.16\r
PROGRESS : false, //\r
\r
- UL_PROGRESS : false,\r
-\r
- CANCELABLE : false,\r
- \r
- TIMEOUT : false\r
+ UL_PROGRESS : false\r
\r
};\r
\r
new X.EventDispatcher(),\r
{\r
\r
- _rawType : X_EventDispatcher_EVENT_TARGET_TYPE.XHR,\r
- _rawObject : X_Net_XHR_W3C || X_Net_XHR_ACTIVE_X,\r
+ '_rawType' : X_EventDispatcher_EVENT_TARGET_TYPE.XHR,\r
+ '_rawObject' : X_Net_XHR_W3C || X_Net_XHR_ACTIVE_X,\r
+ \r
_isXDR : false, // for ie8\r
\r
_method : '',\r
method = obj[ 'method' ],\r
url = obj[ 'url' ],\r
async = obj[ 'async' ],\r
- user = obj[ 'user' ],\r
+ username = obj[ 'username' ],\r
password = obj[ 'password' ],\r
headers = obj[ 'headers' ] || {},\r
postbody = obj[ 'postbody' ],\r
};\r
};\r
\r
- raw.open( method, url, true );\r
+ raw.open( method, url, true, username, password );\r
\r
if( raw.responseType !== undefined ){\r
switch( this._type ){\r
break;\r
};\r
\r
- this.asyncDispatch( 32, { type : X.Event.SUCCESS, status : status || 200, data : data } ); \r
+ this.asyncDispatch( 32, { type : X.Event.SUCCESS, status : status || 200, data : data } );\r
} else {\r
live && this.asyncDispatch( 32, { type : X.Event.ERROR, status : raw.status || 0, percent : 100 } );\r
};\r
this.abspath = X.URL.toAbsolutePath( data.url );\r
this.delay = data.delay || 100;\r
this.timeout = data.timeout || 5000;\r
- //this.timerID = X.Timer.add( this.delay, 0, this, this._detect );\r
\r
this._rawObject.src = this.abspath;\r
\r