$.mobile.changePage()

プログラムからページ遷移を行います。これは内部的にリンクをクリックしたり、フォームをサブミットした際に使われるものです。

引数

to string or object, 必須

  • 文字列指定：絶対/相対URL (“about/us.html”)
  • オブジェクト指定：jQueryコレクションオブジェクト ($(”#about”))

options object, 省略可
以下のようなプロパティを持ちます。

allowSamePageTransition boolean, default: false
初期設定では changePage() は現在アクティブなページへの再リクエストは無視します。このオプションを true にすると、こうしたアクティブページへの遷移も実行するようになります。ただし、ページ切替効果には遷移元と遷移先が異なるページだと決めてかかってつくられているものもあります。そうした効果は期待したようなアニメーションをしない場合もあるので、注意が必要です。開発者は切替効果が上手く動作していることを確認するか、あるいはこうした場合には効果をオフにするなどしてください。
changeHash boolean, default: true
ロケーションバーのハッシュを更新するかどうかを指定します。
data object or string, default: undefined
Ajaxによるページリクエストで送られるデータです。これは changePage() に渡された引数 "to" がURL(文字列指定)の場合のみ有効です。
data-url string, default: undefined
changePage() が完了した際に、ブラウザのロケーションとして更新されるURLです。指定されなかった場合、ページ要素の data-url 属性の値が用いられます。
pageContainer jQuery collection, default: $.mobile.pageContainer
ページが格納された要素を指定します。
reloadPage boolean, default: false
仮にページが既にDOM上に読み込まれていても、強制的に再読み込みします。これは changePage() に渡された引数 "to" がURL(文字列指定)の場合のみ有効です。
reverse boolean, default: false
ページ表示時の切替効果の方向を指定します。
showLoadMsg boolean, default: true
ページ読み込み時のメッセージを表示するかどうかを指定します。
role string, default: undefined
ページが表示される際の data-role の値を指定します。初期値は undefined で、この場合はページ要素に定義されている data-role 属性をそのままにしておきます。
transition string, default: $.mobile.defaultPageTransition
ページ表示時の切替効果を指定します。
type string, default: "get"
ページリクエスト時のメソッド("get"または"post)を指定します。これは changePage() に渡された引数 "to" がURL(文字列指定)の場合のみ有効です。

サンプル

トップページヘ、遷移効果 “flip” を使って遷移します。

$.mobile.changePage( "/doc/jquery_mobile/", { transition: "flip"} );

サンプル実行

IDが “search” のフォームからのデータを使って、検索結果ページへ遷移します。

$.mobile.changePage( "/doc/jquery_mobile/", {
        type: "post",
        data: $("form#search").serialize()
});

サンプル実行

“メソッドとプロパティ“ページへ、効果を逆回しに遷移します。

$.mobile.changePage( "../../", { reverse: true } );

サンプル実行