Source: src/h5.ui.jqm.manager.js

  1. /*
  2.  * Copyright (C) 2012-2016 NS Solutions Corporation
  3.  *
  4.  * Licensed under the Apache License, Version 2.0 (the "License");
  5.  * you may not use this file except in compliance with the License.
  6.  * You may obtain a copy of the License at
  7.  *
  8.  *    http://www.apache.org/licenses/LICENSE-2.0
  9.  *
  10.  * Unless required by applicable law or agreed to in writing, software
  11.  * distributed under the License is distributed on an "AS IS" BASIS,
  12.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13.  * See the License for the specific language governing permissions and
  14.  * limitations under the License.
  15.  *
  16.  * hifive
  17.  */
  19. /* ------ h5.ui.jqm.manager ------ */
  20. (function() {
  21. 	// =========================================================================
  22. 	//
  23. 	// Constants
  24. 	//
  25. 	// =========================================================================
  27. 	var EV_NAME_H5_JQM_PAGE_HIDE = 'h5jqmpagehide';
  28. 	var EV_NAME_H5_JQM_PAGE_SHOW = 'h5jqmpageshow';
  29. 	var EV_NAME_EMULATE_PAGE_SHOW = 'h5controllerready.emulatepageshow';
  31. 	// =============================
  32. 	// Production
  33. 	// =============================
  35. 	// エラーコード
  36. 	var ERR_CODE_INVALID_TYPE = 12000;
  37. 	var ERR_CODE_NAME_INVALID_PARAMETER = 12001;
  39. 	// =============================
  40. 	// Development Only
  41. 	// =============================
  43. 	var fwLogger = h5.log.createLogger('h5.ui.jqm.manager');
  44. 	/* del begin */
  45. 	var FW_LOG_JQM_CONTROLLER_ALREADY_INITIALIZED = '既にJQMマネージャは初期化されています。';
  46. 	var FW_LOG_CONTROLLER_DEF_ALREADY_DEFINED = '既にコントローラ"{0}"はJQMマネージャに登録されています。';
  47. 	var FW_LOG_CSS_FILE_PATH_ALREADY_DEFINED = '既にCSSファイル"{0}"はJQMマネージャに登録されています。';
  49. 	// エラーコードマップ
  50. 	var errMsgMap = {};
  51. 	errMsgMap[ERR_CODE_INVALID_TYPE] = '引数{0}が不正です。正しい値を指定して下さい。';
  52. 	errMsgMap[ERR_CODE_NAME_INVALID_PARAMETER] = '引数の指定に誤りがあります。第2引数にCSSファイルパス、第3引数にコントローラ定義オブジェクトを指定して下さい。';
  53. 	addFwErrorCodeMap(errMsgMap);
  54. 	/* del end */
  57. 	// =========================================================================
  58. 	//
  59. 	// Cache
  60. 	//
  61. 	// =========================================================================
  62. 	// =========================================================================
  63. 	//
  64. 	// Privates
  65. 	//
  66. 	// =========================================================================
  67. 	// =============================
  68. 	// Variables
  69. 	// =============================
  70. 	/**
  71. 	 * ページをの初期化処理呼び出しをpagecreateイベントハンドラで行うかどうか
  72. 	 * <p>
  73. 	 * このフラグがtrueの場合はpagecreateイベントハンドラでページの初期化処理を呼び出します。
  74. 	 * falseの場合はpageinitイベントハンドラでページの初期化処理を呼び出します。
  75. 	 * </p>
  76. 	 * <p>
  77. 	 * jqm1.4より前ではpagecreateイベントはページのDOM拡張前、pageinitイベントはページのDOM拡張後に上がりますが、
  78. 	 * jqm1.4以降ではDOM拡張後にpagecreateが上がり、pageinitイベントはdeprecatedになりました。
  79. 	 * jqm1.4以降ではdeprecatedなpageinitではなくpagecreateイベントハンドラで初期化処理を行うようにします。
  80. 	 * </p>
  81. 	 * <p>
  82. 	 * フラグの値はh5.ui.jqm.manager.init時に設定します。
  83. 	 * </p>
  84. 	 */
  85. 	var shouldHandlePagecreateEvent;
  87. 	/**
  88. 	 * JQMControllerのインスタンス(シングルトン)
  89. 	 */
  90. 	var jqmControllerInstance = null;
  92. 	/**
  93. 	 * コントローラのマップ
  94. 	 * <p>
  95. 	 * キー：ページID、値：コントローラ定義オブジェクト
  96. 	 *
  97. 	 * @type Object
  98. 	 */
  99. 	var controllerMap = {};
  101. 	/**
  102. 	 * コントローラインスタンスのマップ
  103. 	 * <p>
  104. 	 * キー：ページID、値：コントローラインスタンスの配列
  105. 	 *
  106. 	 * @type Object
  107. 	 */
  108. 	var controllerInstanceMap = {};
  110. 	/**
  111. 	 * JQMManagerで管理する、h5.core.controller()で動的に生成されたコントローラインスタンスを保持するマップ
  112. 	 * <p>
  113. 	 * キー：ページID、値：コントローラインスタンスの配列
  114. 	 *
  115. 	 * @type Object
  116. 	 */
  117. 	var dynamicControllerInstanceMap = {};
  119. 	/**
  120. 	 * 初期化パラメータのマップ
  121. 	 * <p>
  122. 	 * キー：ページID、値：初期化パラメータの配列
  123. 	 *
  124. 	 * @type Object
  125. 	 */
  126. 	var initParamMap = {};
  128. 	/**
  129. 	 * CSSファイルのマップ
  130. 	 * <p>
  131. 	 * キー：ページID、値：CSSファイルパスのオブジェクトの配列
  132. 	 *
  133. 	 * @type Object
  134. 	 */
  135. 	var cssMap = {};
  137. 	/**
  138. 	 * h5.ui.jqm.manager.init()が呼ばれたかどうかを示すフラグ
  139. 	 *
  140. 	 * @type Boolean
  141. 	 */
  142. 	var isInitCalled = false;
  144. 	/**
  145. 	 * pagehideイベントが発生したかを判定するフラグ
  146. 	 *
  147. 	 * @type Boolean
  148. 	 */
  149. 	var hideEventFired = false;
  151. 	/**
  152. 	 * 初期表示時、アクティブページにバインドしたコントローラがreadyになるよりも前に、 pageshowが発火したかを判定するフラグ
  153. 	 *
  154. 	 * @type Boolean
  155. 	 */
  156. 	var showEventFiredBeforeReady = false;
  158. 	// =============================
  159. 	// Functions
  160. 	// =============================
  162. 	/**
  163. 	 * アクティブページに設定されているID属性の値を取得します。
  164. 	 * <p>
  165. 	 * アクティブページが存在しない、またはIDが1文字以上の文字列ではない場合nullを取得します。
  166. 	 */
  167. 	function getActivePageId() {
  168. 		var $ap = $.mobile.activePage;
  169. 		var id = $ap && $ap[0] && $ap[0].id;
  170. 		return isString(id) && id.length > 0 ? id : null;
  171. 	}
  173. 	/**
  174. 	 * 現在のアクティブページにコントローラをバインドします。
  175. 	 */
  176. 	function bindToActivePage() {
  177. 		var id = getActivePageId();
  179. 		if (id === null) {
  180. 			return;
  181. 		}
  182. 		// jqmControllerInstanceにインスタンスが格納されるのはinitの中で$(function(){})で囲って行っているため、
  183. 		// bindToActivePageがdocument.readyより前に呼ばれた場合はjqmControllerInstanceに値がまだ入っていない場合がある。
  184. 		// そのためjqmControllerInstanceのメソッド呼び出しは$(function(){})で囲って行っている。
  185. 		$(function() {
  186. 			jqmControllerInstance.addCSS(id);
  187. 			jqmControllerInstance.bindController(id);
  188. 		});
  189. 	}
  191. 	/**
  192. 	 * コントローラインスタンスの__nameプロパティとコントローラ定義オブジェクトの__nameプロパティを比較し、同値であるかを判定します。
  193. 	 *
  194. 	 * @param {Object[]} controllerInstances コントローラインスタンスを保持する配列
  195. 	 * @param {Object} controllerDefObj コントローラ定義オブジェクト
  196. 	 */
  197. 	function equalsControllerName(controllerInstances, controllerDefObj) {
  198. 		var ret = false;
  200. 		for (var i = 0, len = controllerInstances.length; i < len; i++) {
  201. 			var ci = controllerInstances[i];
  202. 			if (ci && ci.__name === controllerDefObj.__name) {
  203. 				ret = true;
  204. 				break;
  205. 			}
  206. 		}
  208. 		return ret;
  209. 	}
  211. 	/**
  212. 	 * JQMマネージャが管理する動的または静的コントローラが持つイベントハンドラの有効・無効化を行います
  213. 	 *
  214. 	 * @param {String} id ページID
  215. 	 * @param {Boolean} flag (true: ハンドラを有効化する / false: ハンドラを無効化する)
  216. 	 */
  217. 	function changeListenerState(id, flag) {
  218. 		for (var prop in controllerInstanceMap) {
  219. 			var controllers = controllerInstanceMap[prop];
  220. 			var pageControllerEnabled = id === prop;
  222. 			for (var i = 0, len = controllers.length; i < len; i++) {
  223. 				var controller = controllers[i];
  225. 				if (pageControllerEnabled) {
  226. 					controller[(flag ? 'enable' : 'disable') + 'Listeners']();
  227. 				}
  228. 			}
  229. 		}
  231. 		for (var prop in dynamicControllerInstanceMap) {
  232. 			var dynamicControllers = dynamicControllerInstanceMap[prop];
  233. 			var dynamicControllerEnabled = id === prop;
  235. 			for (var i = 0, len = dynamicControllers.length; i < len; i++) {
  236. 				var dynamicController = dynamicControllers[i];
  238. 				if (dynamicControllerEnabled) {
  239. 					dynamicController[(flag ? 'enable' : 'disable') + 'Listeners']();
  240. 				}
  241. 			}
  242. 		}
  243. 	}
  245. 	/**
  246. 	 * バージョン文字列の大小を比較する関数
  247. 	 * <p>
  248. 	 * '1.11.0', '1.9.9'のような'.'区切りのバージョン文字列を比較して、第1引数の方が小さければ-1、同じなら0、第2引数の方が小さければ1 を返す。
  249. 	 * </p>
  250. 	 *
  251. 	 * @param {String} a バージョン文字列
  252. 	 * @param {String} b バージョン文字列
  253. 	 * @returns {Integer} 比較結果。aがbより小さいなら-1、同じなら0、aがbより大きいなら1 を返す
  254. 	 */
  255. 	function compareVersion(a, b) {
  256. 		// '.0'が末尾にならない様にする
  257. 		a = a.replace(/(\.0+)+$/, '');
  258. 		b = b.replace(/(\.0+)+$/, '');
  260. 		if (a === b) {
  261. 			// aとbが同じならループで比較せずに0を返す
  262. 			return 0;
  263. 		}
  264. 		var aAry = a.split('.');
  265. 		var bAry = b.split('.');
  267. 		var aAryLen = aAry.length;
  268. 		for (var i = 0; i < aAryLen; i++) {
  269. 			if (bAry[i] == null) {
  270. 				// bAryが先にnullになった=aAryの方が桁数(バージョン文字列の.の数)が多い場合、
  271. 				// '.0'が末尾にならないようにしてあるので、桁数の多い方がバージョンが大きい
  272. 				return 1;
  273. 			}
  274. 			var aVal = parseInt(aAry[i], 10);
  275. 			var bVal = parseInt(bAry[i], 10);
  276. 			if (aVal === bVal) {
  277. 				// 同じなら次以降のindexで比較
  278. 				continue;
  279. 			}
  280. 			// 比較してaが小さいなら-1、bが小さいなら-1を返す
  281. 			return aVal < bVal ? -1 : 1;
  282. 		}
  283. 		if (bAry[aAryLen] != null) {
  284. 			// aAryよりbAryの方が桁数が多い場合はbの方が桁数が多いのでバージョンが大きい
  285. 			return -1;
  286. 		}
  287. 		// 最後まで比較して同じなら同じバージョンなので0を返す
  288. 		return 0;
  289. 	}
  291. 	// =========================================================================
  292. 	//
  293. 	// Body
  294. 	//
  295. 	// =========================================================================
  297. 	/**
  298. 	 * @name jqm
  299. 	 * @memberOf h5.ui
  300. 	 * @namespace
  301. 	 */
  302. 	h5.u.obj.ns('h5.ui.jqm');
  304. 	/**
  305. 	 * hifiveで使用するdata属性のプレフィックス。<br />
  306. 	 * デフォルトは"h5"。
  307. 	 *
  308. 	 * @type String
  309. 	 * @memberOf h5.ui.jqm
  310. 	 * @name dataPrefix
  311. 	 */
  312. 	h5.ui.jqm.dataPrefix = 'h5';
  314. 	/**
  315. 	 * JQMコントローラ
  316. 	 */
  317. 	var jqmController = {
  318. 		/**
  319. 		 * コントローラ名
  320. 		 *
  321. 		 * @memberOf JQMController
  322. 		 */
  323. 		__name: 'JQMController',
  324. 		/**
  325. 		 * __readyイベントのハンドラ
  326. 		 *
  327. 		 * @param {Object} context コンテキスト
  328. 		 * @memberOf JQMController
  329. 		 */
  330. 		__ready: function() {
  331. 			var that = this;
  332. 			var activePageId = getActivePageId();
  334. 			$(':jqmData(role="page"), :jqmData(role="dialog")').each(function() {
  335. 				that.loadScript(this.id);
  336. 			});
  338. 			var $page = this.$find('#' + activePageId);
  340. 			// 初期表示時、トランジションにアニメーションが適用されていない場合、
  341. 			// JQMコントローラがreadyになる前にpageshowが発火してしまいJQMコントローラが拾うことができないため、
  342. 			// 既にpageshowが発火されていたら、h5controllerreadyのタイミングで、h5jqmpageshowをトリガする
  343. 			$page.one(EV_NAME_EMULATE_PAGE_SHOW, function() {
  344. 				if (showEventFiredBeforeReady && $page[0] === $.mobile.activePage[0]) {
  345. 					$page.trigger(EV_NAME_H5_JQM_PAGE_SHOW, {
  346. 						prevPage: $('')
  347. 					});
  348. 				}
  349. 			});
  350. 		},
  351. 		/**
  352. 		 * pageinitイベントのハンドラ
  353. 		 *
  354. 		 * @param {Object} context コンテキスト
  355. 		 * @memberOf JQMController
  356. 		 */
  357. 		':jqmData(role="page"), :jqmData(role="dialog") pageinit': function(context) {
  358. 			// pagecreateイベントを使うべきである場合はpagecreateハンドラ、そうでない時はpageinitハンドラで初期化処理を行う。
  359. 			if (!shouldHandlePagecreateEvent) {
  360. 				this._initPage(context.event.target.id);
  361. 			}
  362. 		},
  364. 		/**
  365. 		 * pagecreateイベントのハンドラ
  366. 		 *
  367. 		 * @param {Object} context コンテキスト
  368. 		 * @memberOf JQMController
  369. 		 */
  370. 		':jqmData(role="page"), :jqmData(role="dialog") pagecreate': function(context) {
  371. 			if (shouldHandlePagecreateEvent) {
  372. 				this._initPage(context.event.target.id);
  373. 			}
  374. 		},
  376. 		/**
  377. 		 * ページの初期化処理を行う
  378. 		 *
  379. 		 * @private
  380. 		 * @param {String} id
  381. 		 * @memberOf JQMController
  382. 		 */
  383. 		_initPage: function(id) {
  384. 			this.loadScript(id);
  385. 			this.addCSS(id);
  386. 			this.bindController(id);
  387. 		},
  389. 		/**
  390. 		 * pageremoveイベントのハンドラ
  391. 		 *
  392. 		 * @param {Object} context コンテキスト
  393. 		 * @memberOf JQMController
  394. 		 */
  395. 		'{rootElement} pageremove': function(context) {
  396. 			// pagehide -> pageremoveの順でイベントは発火するので、pagehideのタイミングでh5jqmpagehideをトリガすればよいが、
  397. 			// 別ページに遷移する際、JQMがpagebeforeloadからpageloadの間のタイミングで、pageremoveをトリガするハンドラをpagehide.removeにバインドしてしまう為、
  398. 			// これ以降にpagehideに対して登録したハンドラは全てpageremoveの後に発火してしまう
  399. 			// 上記の理由により、pageremoveが発生する場合は、このタイミングでh5jqmpagehideイベントをトリガし、
  400. 			// pagehideイベントではh5jqmpagehideイベントを発火しないようフラグで制御する
  401. 			$(context.event.target).trigger(EV_NAME_H5_JQM_PAGE_HIDE, {
  402. 				nextPage: $.mobile.activePage
  403. 			});
  404. 			hideEventFired = true;
  406. 			var id = context.event.target.id;
  407. 			var controllers = controllerInstanceMap[id];
  408. 			var dynamicControllers = dynamicControllerInstanceMap[id];
  410. 			if (controllers) {
  411. 				for (var i = 0, len = controllers.length; i < len; i++) {
  412. 					controllers[i].dispose();
  413. 				}
  415. 				controllerInstanceMap[id] = [];
  416. 			}
  418. 			if (dynamicControllers) {
  419. 				for (var i = 0, len = dynamicControllers.length; i < len; i++) {
  420. 					dynamicControllers[i].dispose();
  421. 				}
  423. 				dynamicControllerInstanceMap[id] = [];
  424. 			}
  425. 		},
  426. 		/**
  427. 		 * pagebeforeshowイベントのハンドラ
  428. 		 *
  429. 		 * @param {Object} context コンテキスト
  430. 		 * @memberOf JQMController
  431. 		 */
  432. 		'{rootElement} pagebeforeshow': function(context) {
  433. 			var id = context.event.target.id;
  435. 			this.addCSS(id);
  436. 			changeListenerState(id, true);
  437. 		},
  438. 		/**
  439. 		 * pagehideイベントのハンドラ コントローラでもページ非表示時のイベントを拾えるようにするため、
  440. 		 * JQMのpagehideイベントと同じタイミングで、JQMマネージャが管理しているコントローラのルート要素に対してh5jqmpagehideイベントをトリガします
  441. 		 * h5jqmpagehideイベントをトリガ後アクティブページ以外のページに対して、コントローラのイベントハンドラの無効化と、 CSSの定義をHEADタグから削除を行います
  442. 		 *
  443. 		 * @param {Object} context コンテキスト
  444. 		 * @memberOf JQMController
  445. 		 */
  446. 		'{rootElement} pagehide': function(context) {
  447. 			if (!hideEventFired) {
  448. 				$(context.event.target).trigger(EV_NAME_H5_JQM_PAGE_HIDE, {
  449. 					nextPage: context.evArg.nextPage
  450. 				});
  451. 			}
  453. 			hideEventFired = false;
  455. 			var id = context.event.target.id;
  457. 			changeListenerState(id, false);
  458. 			this.removeCSS(id);
  459. 		},
  460. 		/**
  461. 		 * コントローラでもページ表示時のイベントを拾えるようにするため、 JQMのpageshowイベントと同じタイミングで、JQMマネージャが管理しているコントローラのルート要素に対して
  462. 		 * h5jqmpageshowイベントをトリガします
  463. 		 *
  464. 		 * @param {Object} context コンテキスト
  465. 		 * @memberOf JQMController
  466. 		 */
  467. 		'{rootElement} pageshow': function(context) {
  468. 			var emulatePageShow = false;
  469. 			var $target = $(context.event.target);
  470. 			var $fromPage = context.evArg ? context.evArg.prevPage : $('');
  471. 			var conAr = controllerInstanceMap[$target[0].id];
  473. 			if (conAr) {
  474. 				for (var i = 0, len = conAr.length; i < len; i++) {
  475. 					var controllerInstance = conAr[i];
  476. 					// isReady=falseであるときコントローラのイベントハンドラは無効であり、
  477. 					// JQMマネージャが管理する静的コントローラがイベントを受け取れない状態なので、h5controllerready後にh5jqmpageshowをトリガするようにする
  478. 					// トランジションのアニメーションが無効(同期でJQMのイベントが発生する)場合のみここに到達する
  479. 					if (!controllerInstance.isReady) {
  480. 						$target.unbind(EV_NAME_EMULATE_PAGE_SHOW).one(EV_NAME_EMULATE_PAGE_SHOW,
  481. 								function() {
  482. 									if ($.mobile.activePage[0] === $target[0]) {
  483. 										$target.trigger(EV_NAME_H5_JQM_PAGE_SHOW, {
  484. 											prevPage: $fromPage
  485. 										});
  486. 									}
  487. 								});
  488. 						emulatePageShow = true;
  489. 						break;
  490. 					}
  491. 				}
  492. 			}
  494. 			if (!emulatePageShow) {
  495. 				$target.trigger(EV_NAME_H5_JQM_PAGE_SHOW, {
  496. 					prevPage: $fromPage
  497. 				});
  498. 			}
  499. 		},
  500. 		/**
  501. 		 * h5controllerboundイベントを監視しコントローラインスタンスを管理するためのイベントハンドラ
  502. 		 *
  503. 		 * @param {Object} context コンテキスト
  504. 		 * @memberOf JQMController
  505. 		 */
  506. 		'{rootElement} h5controllerbound': function(context) {
  507. 			var boundController = context.evArg;
  509. 			if (this === boundController) {
  510. 				return;
  511. 			}
  513. 			var id = getActivePageId();
  515. 			if (id === null) {
  516. 				return;
  517. 			}
  519. 			// define()でバインドしたコントローラも、h5controllerboundイベントを発火するので、
  520. 			// このイベントを発生させたコントローラが、define()によってバインドしたコントローラか判定する
  521. 			// ↑がtrue = 「既にJQMManagerの管理対象になっているコントローラ」なので、dynamicControllerInstanceMapに含めない
  522. 			if ($.inArray(boundController, controllerInstanceMap[id]) !== -1) {
  523. 				return;
  524. 			}
  526. 			if (!dynamicControllerInstanceMap[id]) {
  527. 				dynamicControllerInstanceMap[id] = [];
  528. 			}
  530. 			dynamicControllerInstanceMap[id].push(boundController);
  531. 		},
  532. 		/**
  533. 		 * 動的に生成されたコントローラがunbindまたはdisposeされた場合、JQMManagerの管理対象から除外します
  534. 		 *
  535. 		 * @param context コンテキスト
  536. 		 * @memberOf JQMController
  537. 		 */
  538. 		'{rootElement} h5controllerunbound': function(context) {
  539. 			var unboundController = context.evArg;
  540. 			var id = getActivePageId();
  542. 			if (id === null) {
  543. 				return;
  544. 			}
  546. 			var index = $.inArray(unboundController, dynamicControllerInstanceMap[id]);
  548. 			if (index === -1) {
  549. 				return;
  550. 			}
  552. 			dynamicControllerInstanceMap[id].splice(index, 1);
  553. 		},
  554. 		/**
  555. 		 * 指定されたページIDに紐付くスクリプトをロードする。
  556. 		 *
  557. 		 * @param {String} id ページID
  558. 		 * @memberOf JQMController
  559. 		 */
  560. 		loadScript: function(id) {
  561. 			var page = $('#' + id);
  562. 			var script = $.trim(page.data(this.getDataAttribute('script')));
  564. 			if (script.length === 0) {
  565. 				return;
  566. 			}
  568. 			var src = $.map(script.split(','), function(n) {
  569. 				return $.trim(n);
  570. 			});
  571. 			var async = page.data(this.getDataAttribute('async')) == true;
  573. 			return h5.u.loadScript(src, {
  574. 				async: async
  575. 			});
  576. 		},
  578. 		/**
  579. 		 * JQMコントローラが使用するdata属性にprefixを付けた属性名を返す。
  580. 		 *
  581. 		 * @param {String} attributeName 属性名
  582. 		 * @returns {String} prefixを付けた属性名
  583. 		 */
  584. 		getDataAttribute: function(attributeName) {
  585. 			var prefix = h5.ui.jqm.dataPrefix;
  586. 			if (prefix == null) {
  587. 				prefix = 'h5';
  588. 			}
  589. 			return prefix.length !== 0 ? prefix + '-' + attributeName : attributeName;
  590. 		},
  592. 		/**
  593. 		 * コントローラのバインドを行う
  594. 		 *
  595. 		 * @param {String} id ページID
  596. 		 * @memberOf JQMController
  597. 		 */
  598. 		bindController: function(id) {
  599. 			var controllerDefs = controllerMap[id];
  600. 			var initParams = initParamMap[id];
  602. 			if (!controllerDefs || controllerDefs.length === 0) {
  603. 				return;
  604. 			}
  606. 			if (!controllerInstanceMap[id]) {
  607. 				controllerInstanceMap[id] = [];
  608. 			}
  610. 			var ci = controllerInstanceMap[id];
  612. 			for (var i = 0, len = controllerDefs.length; i < len; i++) {
  613. 				var defObj = controllerDefs[i];
  615. 				if (equalsControllerName(ci, defObj)) {
  616. 					continue;
  617. 				}
  619. 				controllerInstanceMap[id].push(h5.core.controller('#' + id, defObj, initParams[i]));
  620. 			}
  621. 		},
  623. 		/**
  624. 		 * 指定されたページIDに紐付くCSSをHEADに追加する。
  625. 		 *
  626. 		 * @param {String} id ページID
  627. 		 * @memberOf JQMController
  628. 		 */
  629. 		addCSS: function(id) {
  630. 			var src = cssMap[id];
  632. 			if (!src) {
  633. 				return;
  634. 			}
  636. 			var head = document.getElementsByTagName('head')[0];
  637. 			var linkTags = head.getElementsByTagName('link');
  638. 			var linkLen = linkTags.length;
  640. 			for (var i = 0, srcLen = src.length; i < srcLen; i++) {
  641. 				var path = $.mobile.path.parseUrl(src[i]).filename;
  642. 				var isLoaded = false;
  644. 				for (var j = 0; j < linkLen; j++) {
  645. 					var loadedPath = $.mobile.path.parseUrl(linkTags[j].href).filename;
  647. 					if (loadedPath === path) {
  648. 						isLoaded = true;
  649. 						break;
  650. 					}
  651. 				}
  653. 				if (isLoaded) {
  654. 					continue;
  655. 				}
  657. 				var cssNode = document.createElement('link');
  658. 				cssNode.type = 'text/css';
  659. 				cssNode.rel = 'stylesheet';
  660. 				cssNode.href = src[i];
  661. 				head.appendChild(cssNode);
  662. 			}
  663. 		},
  665. 		/**
  666. 		 * 指定されたページIDに紐付くCSSを削除する。
  667. 		 *
  668. 		 * @param {String} id ページID
  669. 		 * @memberOf JQMController
  670. 		 */
  671. 		removeCSS: function(id) {
  672. 			var fromPageCSS = cssMap[id];
  674. 			if (!fromPageCSS) {
  675. 				return;
  676. 			}
  678. 			var id = getActivePageId();
  680. 			if (id === null) {
  681. 				return;
  682. 			}
  684. 			var toPageCSS = cssMap[id];
  686. 			$('link').filter(function() {
  687. 				var href = $(this).attr('href');
  688. 				// 遷移元のページで使用していたCSSファイルを、遷移先のページでも使用する場合はremoveしない
  689. 				return $.inArray(href, fromPageCSS) !== -1 && $.inArray(href, toPageCSS) === -1;
  690. 			}).remove();
  691. 		}
  692. 	};
  694. 	// =============================
  695. 	// Expose to window
  696. 	// =============================
  698. 	/**
  699. 	 * jQuery Mobile専用コントローラマネージャ (JQM Manager)
  700. 	 * <p>
  701. 	 * 現在表示されているページ(アクティブページ)に指定したコントローラとCSSファイルを読み込むという定義を行うことにより、 jQuery
  702. 	 * Mobile特有のページのライフサイクル(DOM生成や破棄)にあわせて、ページに対して
  703. 	 * <ul>
  704. 	 * <li>コントローラで定義したハンドラ</li>
  705. 	 * <li>スタイル(CSSファイル)</li>
  706. 	 * </ul>
  707. 	 * の有効・無効化を行います。
  708. 	 * <p>
  709. 	 * JQM Managerはページ内で動的に作成した(h5.core.controller()で生成した)コントローラも管理します。<br>
  710. 	 * 動的に生成したコントローラもページに紐づくものとして管理し、define()で生成したコントローラと同様に、ページの遷移によってハンドラとスタイルの有効・無効化を行います。
  711. 	 * <p>
  712. 	 * 動的に生成されたコントローラは、そのページに内で起こったユーザー操作などによって初めて作られるものと考えられるため、
  713. 	 * pageremoveイベントが発生してページが破棄されると、そのページに紐づいたコントローラのインスタンスも破棄されます。
  714. 	 *
  715. 	 * @name manager
  716. 	 * @memberOf h5.ui.jqm
  717. 	 * @namespace
  718. 	 */
  719. 	h5.u.obj.expose('h5.ui.jqm.manager',
  720. 			{
  721. 				/**
  722. 				 * jQuery Mobile用hifiveコントローラマネージャを初期化します。
  723. 				 * <p>
  724. 				 * 2回目以降は何も処理を行いません。
  725. 				 *
  726. 				 * @memberOf h5.ui.jqm.manager
  727. 				 * @function
  728. 				 * @name init
  729. 				 */
  730. 				init: function() {
  731. 					if (isInitCalled) {
  732. 						fwLogger.info(FW_LOG_JQM_CONTROLLER_ALREADY_INITIALIZED);
  733. 						return;
  734. 					}
  735. 					isInitCalled = true;
  737. 					// jqmのバージョンを見てpagecreateイベントのタイミングで初期化するべきかどうかのフラグの値をセットする
  738. 					// (initが呼ばれるタイミングではjqmが読み込まれている前提)
  739. 					shouldHandlePagecreateEvent = compareVersion($.mobile.version, '1.4') >= 0;
  741. 					// 初期表示時、JQMマネージャがreadyになる前にpageshowイベントが発火したかをチェックする
  742. 					$(document).one('pageshow', function() {
  743. 						showEventFiredBeforeReady = true;
  744. 					});
  746. 					$(function() {
  747. 						jqmControllerInstance = h5internal.core.controllerInternal('body',
  748. 								jqmController, null, {
  749. 									managed: false
  750. 								});
  751. 						bindToActivePage();
  752. 					});
  753. 				},
  755. 				/**
  756. 				 * jQuery Mobile用hifiveコントローラマネージャにコントローラを登録します。
  757. 				 * <p>
  758. 				 * 「data-role="page"」または「data-role="dialog"」の属性が指定された要素でかつ、
  759. 				 * idが第1引数で指定されたものに一致する要素に対してコントローラを登録します。
  760. 				 * <p>
  761. 				 * 1つのページに複数コントローラを登録することもできます。<br>
  762. 				 * 以下のように、登録したいコントローラ定義オブジェクトの数分、define()を実行して下さい。
  763. 				 *
  764. 				 * <pre>
  765. 				 * h5.ui.jqm.manager.define('pageA', 'css/pageA.css', controllerDefA, defAParams);
  766. 				 * h5.ui.jqm.manager.define('pageA', 'css/pageA.css', controllerDefB, defBParams);
  767. 				 * </pre>
  768. 				 *
  769. 				 * 注意:<br>
  770. 				 * ただし、ページに同じコントローラを2つ以上バインドすることはできません。<br>
  771. 				 * 同じコントローラであるかの判定は、コントローラ定義オブジェクトの<b>__name</b>プロパティの値がバインド済みのコントローラと同値であるか比較し、同値の場合はバインドされません。
  772. 				 *
  773. 				 * @param {String} id ページID
  774. 				 * @param {String|String[]} [cssSrc] CSSファイルのパス
  775. 				 * @param {Object} [controllerDefObject] コントローラ定義オブジェクト
  776. 				 * @param {Object} [initParam] 初期化パラメータ (ライフサイクルイベント(__construct, __init,
  777. 				 *            __ready)の引数にargsプロパティとして渡されます)
  778. 				 * @memberOf h5.ui.jqm.manager
  779. 				 * @function
  780. 				 * @name define
  781. 				 */
  782. 				define: function(id, cssSrc, controllerDefObject, initParam) {
  783. 					if (!isString(id)) {
  784. 						throwFwError(ERR_CODE_INVALID_TYPE, 'id');
  785. 					}
  787. 					if (cssSrc != null && !isString(cssSrc) && !isArray(cssSrc)) {
  788. 						throwFwError(ERR_CODE_INVALID_TYPE, 'cssSrc');
  789. 					}
  791. 					if (controllerDefObject != null) {
  792. 						if (isString(controllerDefObject) || isArray(controllerDefObject)) {
  793. 							throwFwError(ERR_CODE_NAME_INVALID_PARAMETER);
  794. 						}
  796. 						if (!$.isPlainObject(controllerDefObject)
  797. 								|| !('__name' in controllerDefObject)) {
  798. 							throwFwError(ERR_CODE_INVALID_TYPE, 'controllerDefObject');
  799. 						}
  801. 						if (initParam != null && !$.isPlainObject(initParam)) {
  802. 							throwFwError(ERR_CODE_INVALID_TYPE, 'initParam');
  803. 						}
  804. 					}
  806. 					if (!cssMap[id]) {
  807. 						cssMap[id] = [];
  808. 					}
  810. 					if (!controllerMap[id]) {
  811. 						controllerMap[id] = [];
  812. 					}
  814. 					if (!initParamMap[id]) {
  815. 						initParamMap[id] = [];
  816. 					}
  818. 					$.merge(cssMap[id], $.map($.makeArray(cssSrc), function(val, i) {
  819. 						if ($.inArray(val, cssMap[id]) !== -1) {
  820. 							fwLogger.info(FW_LOG_CSS_FILE_PATH_ALREADY_DEFINED, val);
  821. 							return null;
  822. 						}
  823. 						return val;
  824. 					}));
  826. 					if (controllerDefObject) {
  827. 						if ($.inArray(controllerDefObject, controllerMap[id]) === -1) {
  828. 							controllerMap[id].push(controllerDefObject);
  829. 							initParamMap[id].push(initParam);
  830. 						} else {
  831. 							fwLogger.info(FW_LOG_CONTROLLER_DEF_ALREADY_DEFINED,
  832. 									controllerDefObject.__name);
  833. 						}
  834. 					}
  836. 					if (isInitCalled && getActivePageId() !== null) {
  837. 						bindToActivePage();
  838. 					} else {
  839. 						this.init();
  840. 					}
  841. 				}
  842. 				/* del begin */
  843. 				,
  844. 				/*
  845. 				 * テスト用に公開
  846. 				 * JQMControllerが管理しているコントローラへの参照と、JQMControllerインスタンスへの参照を除去し、JQMControllerをdisposeをします。
  847. 				 *
  848. 				 * @memberOf h5.ui.jqm.manager
  849. 				 * @function
  850. 				 * @name __reset
  851. 				 */
  852. 				__reset: function() {
  853. 					if (jqmControllerInstance) {
  854. 						jqmControllerInstance.dispose();
  855. 						jqmControllerInstance = null;
  856. 					}
  857. 					controllerMap = {};
  858. 					controllerInstanceMap = {};
  859. 					dynamicControllerInstanceMap = {};
  860. 					initParamMap = {};
  861. 					cssMap = {};
  862. 					isInitCalled = false;
  863. 					hideEventFired = false;
  864. 					showEventFiredBeforeReady = false;
  865. 				}
  866. 			/* del end */
  867. 			});
  868. })();