$.mobile.loadPage()

ページを読み込み、コンテンツを拡張し、DOMに挿入します。このメソッドは $.mobile.changePage メソッドで、最初の引数がURLだった場合に呼び出されるものです。この関数では現在表示中のページには影響を与えませんので、読み込みをバックグラウンドで行うために使われます。この関数は、戻り値に deferred オブジェクトを返します。これによって拡張され、ドキュメントに挿入された後のページを resolve できます。

引数

url string or object, 必須
絶対/相対URL
options object, 省略可
以下のようなプロパティを持ちます。

data object or string, default: undefined
Ajaxによるページリクエストで送られるデータです。
loadMsgDelay number (in ms), default: 50
読み込み中メッセージが表示されるまでの時間をミリ秒で指定します。これにより、既に読み込まれているページではメッセージが表示されることを避けることが出来ます。
pageContainer jQuery collection, default: $.mobile.pageContainer
ページが格納された要素を指定します。
reloadPage boolean, default: false
仮にページが既にDOM上に読み込まれていても、強制的に再読み込みします。
role string, default: undefined
ページが表示される際の data-role の値を指定します。初期値は undefined で、この場合はページ要素に定義されている data-role 属性をそのままにしておきます。
type string, default: "get"
ページリクエスト時のメソッド(“get“または“post)を指定します。

サンプル

“about/us.html” を読み込み、DOMに挿入します。

$.mobile.loadPage( "about/us.html" );

検索結果ページを、IDが“search“のフォームデータを使って読み込みます。

$.mobile.loadPage( "searchresults.php", {
        type: "post", 
        data: $("form#search").serialize()
});