jQuery Mobile １つのHTMLファイルに複数ページを記述する

公開日：2014年10月10日
最終更新日：2014年11月9日

jQuery Mobile では１つのHTMLファイルに複数のページを含めることができます。１回で複数ページのダウンロードが済むため効率的になる場合もありますが、閲覧しないページも含まれるとかえって無駄になってしまう場合もありますので状況により使い分けましょう。

«次の特集記事» jQuery Mobile ページを構成するUI要素(ウィジェット)の指定方法
«前の特集記事» jQuery Mobile ページ遷移の仕組み

jQuery Mobile 特集記事一覧

【コンテンツ】

複数ページの記述方法
それぞれのページへのリンクの仕方
ダイアログを表示する

【記事執筆時の環境】
jQuery Mobile 1.4.4/1.4.5

複数ページの記述方法

jQuery Mobile では、div要素に「data-role="page"」と指定した部分が１ページとして認識されます。
したがって別々のページとして認識させたい場合は、「data-role="page"」を指定したdiv要素のかたまりを複数設置すればよいわけです。
この時それぞれのdiv要素には必ずidを付与します。

以下は記述例です。

<div data-role="page" id="top">
	<div role="main" class="ui-content">
		<p>ここはトップページです</p>
	</div>
</div>

<div data-role="page" id="sub">
	<div role="main" class="ui-content">
		<p>ここはサブページです</p>
	</div>
</div>

<p>ここはトップページです</p>

</div>

<p>ここはサブページです</p>

</div>

それぞれのページへのリンクの仕方

最初にページにアクセスしたときは、「data-role="page"」が記述された一番上の要素が表示されます。
別のページへ移動したいときは、idにハッシュマークをつけて「#sub」などとリンク先に指定します。

以下は複数ページを記述したフルのHTMLの例です。

<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>jQuery Mobile Tips</title>
<link rel="stylesheet" href="http://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
<script src="http://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="http://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
<style type="text/css">
.ui-header .ui-title {
	margin: 0 10px;
}
.ui-footer {
	font-size: 13px;
	text-align: center;
}
</style>
</head>
<body>

<div data-role="page" id="top">
	<div data-role="header">
		<h1>DEMOページ トップ</h1>
	</div>
	<div role="main" class="ui-content">
		<p>ここはトップページです</p>
		<a href="#sub">サブページへ移動 &raquo;</a>
	</div>
	<div data-role="footer">
		<p>
			<script type="text/javascript">
			var today = new Date();
			var y = today.getFullYear();
			document.write("&copy; " + y + " Web Tips アーカイブ");
			</script> 
		</p>
	</div>
</div>

<div data-role="page" id="sub">
	<div data-role="header">
		<h1>DEMOページ サブ</h1>
	</div>
	<div role="main" class="ui-content">
		<p>ここはサブページです</p>
		<a href="#top">トップページへ移動 &raquo;</a>
	</div>
	<div data-role="footer">
		<p>
			<script type="text/javascript">
			var today = new Date();
			var y = today.getFullYear();
			document.write("&copy; " + y + " Web Tips アーカイブ");
			</script> 
		</p>
	</div>
</div>

</body>
</html>

<!DOCTYPE html>

<head>

<title>jQuery Mobile Tips</title>

.ui-header .ui-title {

margin: 0 10px;

}

.ui-footer {

font-size: 13px;

text-align: center;

}

</style>

</head>

<body>

<h1>DEMOページトップ</h1>

</div>

<p>ここはトップページです</p>

<a href="#sub">サブページへ移動 »</a>

</div>

<p>

var today = new Date();

var y = today.getFullYear();

document.write("© " + y + " Web Tips アーカイブ");

</script>

</p>

</div>

<h1>DEMOページサブ</h1>

</div>

<p>ここはサブページです</p>

<a href="#top">トップページへ移動 »</a>

</div>

<p>

var today = new Date();

var y = today.getFullYear();

document.write("© " + y + " Web Tips アーカイブ");

</script>

</p>

</div>

</body>

</html>

DEMOページへ »

ダイアログを表示する

「data-role="page"」を指定したdiv要素には、ダイアログのようにページを表示するオプションを指定できます。
以下のように「data-dialog="true"」と指定します。

<div data-role="page" data-dialog="true" id="sub">
	<div data-role="header">
		<h1>ダイアログ</h1>
	</div>
	<div role="main" class="ui-content">
		<p>ダイアログを表示しています</p>
		<a href="#top">トップページへ移動 &raquo;</a>
	</div>
</div>

<h1>ダイアログ</h1>

</div>

<p>ダイアログを表示しています</p>

<a href="#top">トップページへ移動 »</a>

</div>

DEMOページへ »

ダイアログにはデフォルトで「×」の形をしたダイアログを閉じるアイコンが左上に表示されます。
これを data-close-btn属性で右上にしたり表示なしにすることができます。

データ属性指定	説明
data-close-btn="left" (デフォルト)	アイコンを左上に表示
data-close-btn="right"	アイコンを右上に表示
data-close-btn="none"	アイコンを表示しない

初期の頃はページ切り替えが速いという理由で、jQuery Mobileでは１ファイルに複数ページを記載する方法を推奨していました。しかしあまりにも多くのページを含めるのは無駄なトラフィックを生む原因となり、最初のページ表示に時間がかかってしまいます。
複数ページを記載するのはそのファイルのメインページに付随するダイアログや、一連の流れで順番に表示するページに限った方が良いでしょう。

«次の特集記事» jQuery Mobile ページを構成するUI要素(ウィジェット)の指定方法
«前の特集記事» jQuery Mobile ページ遷移の仕組み

jQuery Mobile 特集記事一覧