X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=0.6.x%2Fjs%2F01_core%2F01_X.js;h=5b760244e0ad403e3312448f26db4c90a9f00323;hb=d836e6243878426d4cfd7a14ceb9b77db9f92b57;hp=9706243a0e8aa4e2ec5536b230e742a410b633ec;hpb=5f61a48d303bf9ca6bf021d8957aac743fc8958b;p=pettanr%2FclientJs.git

diff --git a/0.6.x/js/01_core/01_X.js b/0.6.x/js/01_core/01_X.js
index 9706243..5b76024 100644
--- a/0.6.x/js/01_core/01_X.js
+++ b/0.6.x/js/01_core/01_X.js
@@ -1,28 +1,107 @@
 
-if( !window['console'] || ( window.parent && window.parent.log ) ) console = { log : function(a){
-	var win, elm;
-	//alert(a);
-	if( window.parent ){
-		elm = parent.document.all ? parent.document.all.log : parent.log || parent.document.getElementById( 'log' );
-		elm && ( elm.innerHTML = a + '<br>' + elm.innerHTML );
+/**
+ * <h4>はじめに:Web 開発の世界へようこそ！</h4>
+ * DHTML と XHR 等を活用した Ajax によってその真価を発揮した javascript は、現在では RIA に SPA や 3D ゲームなど、あらゆるアプリケーションがブラウザ上で動きつつあります。
+ * それらの素晴らしいデモに触れ、これから Web 開発に望む皆さんは、胸をときめかせていることでしょう。
+ * そうです、今や Web ブラウザは、あなたの夢を何でも描くことの出来る自由なフロンティアです。
+ * 
+ * しかし、いざ Javascript を触り始め、初めての開発に着手すると、Web ブラウザというフロンティアは、少し雑草の茂るだけの荒野だと気付くでしょう。
+ * ここに RIA や 3D ゲームといった素晴らしいテーマパークを築機上げるには、まずは測量に整地、地盤や土壌の改良といった膨大な作業をしなくてはいけません。
+ * 
+ * 簡素な物置小屋のための最初の柱を建てるのにも、それ以前に膨大な作業の必要なことに、あなたは唖然となるでしょう。
+ * そのような基礎もそこそこに、勇んで建てた一本目の柱は傾き、または無残に朽ち果てるのを目撃し、あなたは深いため息をつくかもしれません。
+ * 
+ * Javascript は様々な問題を孕みつつも、今や最もあらゆるプラットフォームで動作する言語のひとつへと躍進しました。
+ * これから、このフロンティアに如何に基礎を作り、その上にテーマパークを作るのか？一緒に考えていきましょう。
+ * ようこそ、Web 開発の世界へ！
+ * 
+ * <h4>pettanR フレームワーク API ドキュメントについて</h4>
+ * このAPIドキュメントには、折に触れこのような長文が登場します。
+ * Web 開発は今では、そのカジュアルなイメージとは裏腹に、膨大な知識と経験が必要なものになってしまっています。
+ * どのようにして、それらの情報を、妥当な業務時間の間に継承していけばよいか？
+ * 
+ * この意識は常にありましたが、このたび pettanR フレームワークの API ドキュメントを作成するにあたり、それに付記していく形で取り組んでみようと思います。
+ * 
+ * <h4>フレームワークのレイヤー構造について</h4>
+ * <h5>\core 以下:javascript の整地を行い大規模開発の基礎を整える</h5>
+ * <p>ブラウザの種類とバージョンを調べ、続いて javascript 自体の差異を埋め、足りない関数を補います。
+ * <p>続いて、ファーストオブジェクトとも呼ばれる function について、その能力を引き出しつつ安心して使えるように、再利用可能クロージャの生成・破棄ができるようにします。
+ * ガベージコレクション周りが怪しいブラウザがあるため、クロージャを再利用可能にしておくことは重要です。
+ * <p>javascript が大規模開発に使えるように、クラス定義関数を用意します。prototype 周りの差異やバグを吸収するためにも、クラス定義の共通化は有効です。
+ * <p>このクラス定義関数を用いて EventDispatcher クラスを定義します。ブラウザの提供するイベントターゲットオブジェクトをラップしたり、単にアプリケーション独自のイベントを配信するためにも使えます。
+ * フレームワークの各所でサブクラスや単にインスタンスを拡張して使われています。フレームワークの API 設計の性格を決めている、とても重要なクラスです。
+ * 再利用可能クロージャや、タイマー(setTimeout のラッパー) とも密に結合しています。
+ * 
+ * <h5>\dom 以下:DHTML の差異を吸収し、非同期化された仮想 Node を提供する</h5>
+ * <p>jQuery ライクな構文で DOM ツリーの操作を行います。チェーンメソッドは速い、と聞きかじったのでこのデザインにしました。
+ * <p>Real DOM の操作は非同期に行われるため高速です。Virtual DOM 時代のライバル達にひけをとることはありません。
+ * <p>10 年後の変化に対応するため、確かな抽象化実装を行う。それを証明するために 10 年前の環境でも動作させます。
+ * 
+ * <h5>\ui 以下:UI フレームワーク</h5>
+ * <p>\dom までで吸収できなかった Web ブラウザの差異を最終的に吸収し、HTML 要素を UI 部品として利用するためのレイヤーです。
+ * <p>この層で吸収できなかった差異に関する情報を提供して、アプリケーションに UI をグレースフルグラデーションするための情報を提供します。
+ * <p>任意の UI を実現するための最適な HTML タグ構造がブラウザ毎に異なる場合に、その差異をカプセル化します。
+ * <p>Web ブラウザ自体のレンダリングコストを最小にし、高速な UI 部品を提供するために、独自のレイアウトルールを持ちます。
+ * <p>フォントサイズをベースとしたレイアウト指定のため、レスポンシブな画面作りを後押しします。
+ * 
+ * @example // ライブラリは X という名前空間を使用します。
+ * //ショートハンド
+ * X( func ) == X.ViewPort[ 'listenOnce' ](X.Event.XDOM_READY, func);
+ * X('#mydiv') == X.Doc.find('#mydiv');
+ * @namespace X
+ */
+function X( v ){
+	if( X_Type_isFunction( v ) ){
+		X[ 'ViewPort' ][ 'listenOnce' ]( X_EVENT_XDOM_READY, v );
+	} else
+	if( X_shortcutFunction ){
+		return X_shortcutFunction.apply( X_shortcutContext || X, arguments );
 	};
-} };
+};
+
+//{+DEV
+if( !window['console'] || ( window.parent && window.parent.log ) )
+	console = { log : function(a){
+		var win, elm;
+		//alert(a);
+		if( window.parent ){
+			elm = parent.document.all ? parent.document.all.log : parent.log || parent.document.getElementById( 'log' );
+			elm && ( elm.innerHTML = a + '<br>' + elm.innerHTML );
+		};
+	} };
+//+DEV}
+
+//{-AUDIO
+//-AUDIO}
 
 var undefined,
-	X = new Function( 'return X._shortcut && X._shortcut.apply( X._shortcut, arguments )' ),
-	X_TEMP = { onSystemReady : [] };
+	X_EMPTY_OBJECT = {},
+	X_TEMP = { onSystemReady : [] },
+	X_emptyFunction = new Function,
+	X_shortcutFunction,
+	X_shortcutContext;
 
-X.VERSION = '0.6.89';
-		
-X.bootTime = + new Date;
-		
-X.getTime = Date.now ? Date.now : new Function( 'return +new Date' );
+/**
+ * バージョン文字列:"0.6.123"
+ * @type {string} */
+X[ 'VERSION' ] = '0.6.127';
 
+/**
+ * ブートタイム ms
+ * @type {number} */
+X[ 'bootTime' ] = + new Date;
 
-X.emptyFunction = new Function;
+/**
+ * 空の関数
+ * @type {Function} */
+X[ 'emptyFunction' ] = X_emptyFunction;
 
-		// defer の場合もあるので、document.readyState を見る MacIE で false
-X.inHead = (function( s ){
+/**
+ * このscriptはheadタグの中にあるか？
+ *  @type {boolean} */
+// TODO defer の場合もあるので、document.readyState を見る
+// MacIE で false
+X[ 'inHead' ] = (function( s ){
 	if( !s ) return false;
 	if( !s.length ) return false; // Safari1.3 312.8 でerror
 	s = s[ s.length - 1 ];