はじめに
ページ構造
jQuery Mobile は data-role 属性で HTML を拡張します。ページは、header、main、footer のセクションを含む data-role=page の div です。モバイルデバイスで正しく拡大縮小するには viewport のメタタグが不可欠です。jquery.mobile.js の前に jQuery コアを読み込みましょう。
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
</head>
<body>
<div data-role="page" id="home">
<div data-role="header"><h1>Home</h1></div>
<div data-role="main" class="ui-content">Content</div>
<div data-role="footer"><h4>Footer</h4></div>
</div>
</body>
</html>1 文書内の複数ページ
1 つの HTML ファイルに複数の data-role=page の div を置けます。アンカーの href(#about)で互いにリンクしましょう。jQuery Mobile は 1 度に 1 ページを表示し、遷移をアニメーションします。初期ロードで表示されるのは、ソース順の最初のページだけです。
<div data-role="page" id="home">
<div data-role="header"><h1>Home</h1></div>
<div data-role="main" class="ui-content">
<a href="#about" class="ui-btn">Go to About</a>
</div>
</div>
<div data-role="page" id="about" data-theme="b">
<div data-role="header"><h1>About</h1></div>
<div data-role="main" class="ui-content">
<a href="#home" class="ui-btn" data-direction="reverse">Back</a>
</div>
</div>AJAX ナビゲーションとリンク
デフォルトでは、内部(#id)と同一オリジンのページへのリンクは AJAX で取得され、遷移と共に差し替えられます。通常のフルページロードを強制するには data-ajax=false を使いましょう(jQuery Mobile 以外のページに有用)。data-prefetch でターゲットを先取りすれば、遷移が即時になります。
<!-- Default: links load via AJAX and animate a transition -->
<a href="detail.html" class="ui-btn">Open detail (AJAX)</a>
<!-- Force a full page reload (no AJAX) -->
<a href="external.html" data-ajax="false">Full reload</a>
<!-- Open in new window/tab -->
<a href="https://example.com" rel="external">External site</a>
<!-- Prefetch a page when this page loads -->
<a href="next.html" data-prefetch="true" class="ui-btn">Prefetch next</a>先取りと DOM キャッシュ
先取りはリンク先ページをバックグラウンドでロードし、ナビゲーションが即時に感じられます。デフォルトでは訪問済みページは DOM から取り除かれますが、domCache はメモリを代償に、速い「戻る」ナビゲーションのためにページを保持します。ページごとには data-dom-cache で、グローバルにはページのプロトタイプオプションで有効化しましょう。
<!-- Prefetch several pages -->
<a href="page1.html" data-prefetch="true">Page 1</a>
<a href="page2.html" data-prefetch="true">Page 2</a>
<!-- Globally enable DOM caching of visited pages -->
<script>
$(document).on("mobileinit", function () {
$.mobile.page.prototype.options.domCache = true;
});
</script>
<!-- Cache a single page -->
<div data-role="page" id="cached" data-dom-cache="true">...</div>ダイアログページ
リンクに data-rel=dialog を(またはページに data-dialog=true を)加えると、閉じるボタンと遷移を備えたモーダルダイアログ風のページが開きます。前のページへ戻って閉じるには、リンクに data-rel=back を使いましょう。
<!-- Open a page as a dialog -->
<a href="#dialog" class="ui-btn" data-rel="dialog">Open dialog</a>
<div data-role="page" id="dialog" data-dialog="true">
<div data-role="header"><h1>Dialog</h1></div>
<div data-role="main" class="ui-content">
<p>This page is styled as a dialog.</p>
<a href="#" class="ui-btn" data-rel="back">Close</a>
</div>
</div>グローバル設定(mobileinit)
mobileinit イベントは、jQuery コアの読み込み後、jQuery Mobile の初期化前に発火します — jquery.mobile.js を読み込む「前に」ここで設定を bind しましょう。よくある上書き:デフォルトの遷移、AJAX の設定、ローディングメッセージのテキスト。autoInitializePage=false で、最初のページの初期化タイミングを制御できます。
<script src="jquery-1.11.1.min.js"></script>
<script>
// Bind BEFORE loading jquery.mobile.js
$(document).on("mobileinit", function () {
$.mobile.defaultPageTransition = "slide";
$.mobile.defaultDialogTransition = "pop";
$.mobile.loadingMessage = "Loading...";
$.mobile.ajaxEnabled = true;
$.mobile.linkBindingEnabled = true;
$.mobile.autoInitializePage = true;
});
</script>
<script src="jquery.mobile-1.4.5.min.js"></script>ページの遷移
基本の遷移
リンクに data-transition を加えると、ナビゲーション時のアニメーションを選べます。遷移は CSS ベースです(可能な限りハードウェア加速)。'none' でアニメーションをスキップし、即時ナビゲーションに なります。同じ属性がダイアログとポップアップにも効きます。
<!-- Apply a transition to a link -->
<a href="#page2" data-transition="slide">Slide</a>
<a href="#page2" data-transition="fade">Fade</a>
<a href="#page2" data-transition="pop">Pop</a>
<a href="#page2" data-transition="flip">Flip</a>
<a href="#page2" data-transition="none">None (instant)</a>遷移のタイプ
jQuery Mobile には 2D/3D の CSS 遷移のセットが付属します。3D 遷移(turn、flow、flip)は性能のあるデバイスでは素晴らしく、古いハードウェアでは優雅にフォールバックします。pop と fade が最も高性能で、ダイアログとポップアップには推奨です。
<!-- Available transitions in jQuery Mobile 1.4 -->
fade <!-- default, fade in/out -->
pop <!-- scale in from center (good for dialogs) -->
slide <!-- slide left to right -->
slideup <!-- slide up from bottom -->
slidedown <!-- slide down from top -->
slidfade <!-- slide + fade -->
turn <!-- 3D turn -->
flow <!-- 3D flow -->
flip <!-- 3D flip -->
none <!-- no animation -->方向と逆再生
data-direction=reverse は遷移を逆再生します — 通常は「戻る」ボタンに使い、アニメーションが前進ナビゲーションを映し返すようにします。data-transition と組み合わせます。遷移が設定されていなければ、デフォルトが反転されます。
<!-- Reverse a transition (e.g., for Back buttons) -->
<a href="#home" data-transition="slide" data-direction="reverse">Back</a>
<!-- Globally reverse the default -->
<a href="#home" data-direction="reverse">Back (uses default transition reversed)</a>ダイアログの遷移
ダイアログはどんな遷移でも使えますが、モーダルには pop と slidedown が最も自然に感じられます。mobileinit 中に $.mobile.defaultDialogTransition でグローバルのデフォルトを設定しましょう。ダイアログの close 操作が遷移を自動的に逆再生します。
<!-- Combine data-rel=dialog with a transition -->
<a href="#settings" data-rel="dialog" data-transition="pop">Settings</a>
<a href="#settings" data-rel="dialog" data-transition="slidedown">Settings (slide down)</a>
<!-- Set a global default dialog transition -->
<script>
$(document).on("mobileinit", function () {
$.mobile.defaultDialogTransition = "pop";
});
</script>無効化とフォールバック
data-transition=none を設定するか、グローバルのデフォルトを 'none' にすればアニメーションが無効化されます — 低スペックのデバイスやアクセシビリティに有用です。jQuery Mobile は 3D transform の対応を自動検出し、非対応のとき 3D 遷移(flip、turn、flow)を単純な fade へ劣化させます。
<!-- Disable transitions for a specific link -->
<a href="#page2" data-transition="none">No animation</a>
<!-- Globally disable (useful for older devices / testing) -->
<script>
$(document).on("mobileinit", function () {
$.mobile.defaultPageTransition = "none";
$.mobile.defaultDialogTransition = "none";
});
</script>
<!-- 3D transitions fall back to fade when not supported -->ツールバー(Header と Footer)
固定の Header と Footer
data-position=fixed を加えると、ページがスクロールしても header や footer がビューポートの上端/下端に張り付きます。デフォルトではページをタップするとツールバーの表示がトグルします。ツールバーの後ろに隠れないよう、ページのコンテンツにパディングが付きます。
<div data-role="page" id="home">
<div data-role="header" data-position="fixed">
<h1>Fixed Header</h1>
</div>
<div data-role="main" class="ui-content">
<p>Scroll the page — the toolbars stay in place.</p>
</div>
<div data-role="footer" data-position="fixed">
<h4>Fixed Footer</h4>
</div>
</div>フルスクリーンのツールバー
data-fullscreen=true は、スペースを確保する代わりに、固定ツールバーをコンテンツの上に(半透明で)重ねます。コンテンツが画面を満たすべきフォトビューアや地図に最適です。ツールバーは固定ツールバーと同じく、タップで現れたり消えたりします。
<div data-role="page" id="photo">
<div data-role="header" data-position="fixed" data-fullscreen="true">
<h1>Photos</h1>
</div>
<div data-role="main" class="ui-content">
<img src="photo.jpg" style="width:100%">
</div>
<div data-role="footer" data-position="fixed" data-fullscreen="true">
<h4>Footer over content</h4>
</div>
</div>永続的なツールバー
2 つのページが同じ data-id と data-position=fixed を持つ footer(または header)を持つとき、ツールバーはページと共にアニメーションせず、ページ遷移をまたいで持続します。これが永続的な下部ナビゲーションバーの標準パターンです — ページごとに変化するのはアクティブなリンクだけです。
<!-- Both pages use the SAME data-id so the footer persists -->
<div data-role="page" id="home">
<div data-role="footer" data-id="main-nav" data-position="fixed">
<div data-role="navbar">
<ul><li><a href="#home" class="ui-btn-active">Home</a></li>
<li><a href="#settings">Settings</a></li></ul>
</div>
</div>
</div>
<div data-role="page" id="settings">
<div data-role="footer" data-id="main-nav" data-position="fixed">
<div data-role="navbar">
<ul><li><a href="#home">Home</a></li>
<li><a href="#settings" class="ui-btn-active">Settings</a></li></ul>
</div>
</div>
</div>タップトグルの挙動
固定ツールバーは、ユーザーがページをタップすると表示がトグルします。ツールバーを常に表示させるには data-tap-toggle=false を設定しましょう。関連する要素ごとのオプション:data-hide-during-focus(入力にフォーカスしたとき隠す)、data-update-page-padding(リサイズ時にページのパディングを再適用)。
<!-- Disable tap-to-toggle on a fixed toolbar -->
<div data-role="header" data-position="fixed" data-tap-toggle="false">
<h1>Always visible</h1>
</div>
<!-- Globally turn off tap toggle -->
<script>
$(document).on("mobileinit", function () {
$.mobile.toolbar.prototype.options.tapToggle = false;
});
</script>ツールバーのテーマとボタン
header には、ui-btn-left / ui-btn-right のクラスで配置されたボタンを置けます。data-theme がバーのカラースウォッチを設定し、data-iconpos=notext でコンパクトな見た目にアイコンだけを表示します。header 内のボタンは自動的にインラインボタンとして整形されます。
<div data-role="header" data-theme="b">
<a href="#" class="ui-btn-left" data-icon="home" data-iconpos="notext">Home</a>
<h1>Title</h1>
<a href="#" class="ui-btn-right" data-icon="gear" data-iconpos="notext">Settings</a>
</div>ツールバーの動的な更新
実行時にツールバーのマークアップを変えた後は、$(el).toolbar('refresh') を呼び、スタイリングとパディングを再適用しましょう。toolbar ウィジェット(1.4 で導入)が固定位置とタップトグルを管理します。ページ作成後にツールバーを追加した場合は、$().toolbar() で手動初期化しましょう。
<script>
// Update the header title and re-enhance after DOM change
$(function () {
$("#my-header h1").text("New Title");
$("#my-header").toolbar("refresh");
});
</script>
<div data-role="header" id="my-header" data-position="fixed">
<h1>Old Title</h1>
</div>リストビュー
基本の Listview
<ul> に data-role=listview を加えると、全幅でタップ可能な行を持つタッチフレンドリーなリストになります。<a> を含む各 <li> が、右矢印付きのリンク行になります。data-inset=true で、端から端までではなく角丸とマージン付きのインセット表示になります。