var listener;\r
\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
+ * <p>クロージャに関するポリシーと再利用可能クロージャについて次の記事をご覧ください。\r
+ * <a href="http://outcloud.blogspot.jp/2015/05/reusable-closure.html" target="_blank">再利用できるクロージャを使ったWebアプリケーション開発</a>\r
* \r
* <h5>再利用可能クロージャの作成</h5>\r
* X_Callback_create() で再利用可能なクロージャの作成。次のパターンで呼び出します。<br>\r
*/\r
func : undefined,\r
/**\r
+ * コールバック名。コールバック作成時に関数が無い、関数が入れ替わっていても動作する。\r
+ * @type {string|undefined} \r
+ */\r
+ name : undefined,\r
+ /**\r
* コールバックの this コンテキスト。 \r
* @type {listener|object|undefined}\r
*/\r
/**\r
* X.Timer と X.EventDispaｔcher からのコールバックの返り値を定義。\r
* @namespace X.Callback\r
- * @alias X.Callback\r
*/\r
X[ 'Callback' ] = {\r
/**\r
* このコールバックでは返り値による操作は無い。\r
+ * @alias X.Callback.NONE\r
*/\r
'NONE' : X_Callback_NONE,\r
/**\r
* X.Timer, X.EventDispaｔcher のコールバックでタイマーやイベントリスナの解除に使用。\r
+ * @alias X.Callback.UN_LISTEN\r
*/\r
'UN_LISTEN' : X_Callback_UN_LISTEN,\r
/**\r
* 上位階層へのイベント伝播のキャンセル。DOM イベントのコールバックの戻り値に指定すると e.stopPropagation() が呼ばれる。\r
+ * @alias X.Callback.STOP_PROPAGATION\r
*/\r
'STOP_PROPAGATION' : X_Callback_STOP_PROPAGATION,\r
/**\r
* 以降のイベントのディスパッチを中断する。STOP_PROPAGATION との違いは、次に控えているコールバックもキャンセルされる点。但し system によって追加されたイベントはキャンセルされない。\r
+ * @alias X.Callback.STOP_NOW\r
*/\r
'STOP_NOW' : X_Callback_STOP_NOW,\r
/**\r
* DOM イベントのコールバックの戻り値に指定すると e.preventDefault() が呼ばれる。\r
* またフレームワーク内で定義されたデフォルト動作の回避にも使用される。\r
+ * @alias X.Callback.PREVENT_DEFAULT\r
*/\r
'PREVENT_DEFAULT' : X_Callback_PREVENT_DEFAULT,\r
- \r
/**\r
- * X.UI に於いて、ポインターイベントの戻り値に指定すると、以降のポインターベントを独占する。\r
+ * X.UI の uinode でポインターイベントの戻り値に指定すると、以降のポインターベントを独占する。\r
+ * @alias X.Callback.CAPTURE_POINTER\r
*/\r
'CAPTURE_POINTER' : X_Callback_CAPTURE_POINTER,\r
- \r
+ /**\r
+ * X.UI の uinode でポインターイベントの戻り値に指定すると、以降のポインターベントを独占を解除する。\r
+ * @alias X.Callback.RELEASE_POINTER\r
+ */\r
'RELEASE_POINTER' : X_Callback_RELEASE_POINTER\r
};\r
\r
OSDN Git Service
