jQuery Mobile的API默認(rèn)配置
mobileinit事件
當(dāng)jQuery Mobile開始執(zhí)行的時(shí)候, 它會(huì)在document對(duì)象上觸發(fā)一個(gè)mobileinit 事件, 你可以重寫jQuery Mobile默認(rèn)的響應(yīng)函數(shù).
$(document).bind("mobileinit", function(){ //這里是重寫的代碼 });
mobileinit
由于mobileinit事件會(huì)在執(zhí)行jquery mobile的時(shí)候立即被觸發(fā),你可能會(huì)需要在jQuery Mobile加載之前綁定你的事件處理函數(shù).基于此,我們推薦您按以下順序來加載JavaScript文件:
- <script src="jquery.js"></script> <script src="您自己的js文件.js"></script>
- <script src="jquery-mobile.js"></script>
在綁定事件的函數(shù)內(nèi)部,你可以使用$.mobile對(duì)象的$.extend方法來配置默認(rèn)參數(shù)值:
- $(document).bind("mobileinit", function(){ $.extend( $.mobile , { foo:
- bar }); });
或者單獨(dú)設(shè)置它們:
- $(document).live("mobileinit", function(){ $.mobile.foo = bar;
- });
配置選項(xiàng)
以下是 $.mobile對(duì)象的可配置選項(xiàng)以及其默認(rèn)值:
subPageUrlKey (string, default: "ui-page"):
url參數(shù)用來引用由插件生成的子頁面(例如那些由嵌套的listview生成的子頁面) 例如: example.html&ui-page=subpageIdentifir. 在&ui-page=前的部分被jquery mobile框架用來向子頁面所在的URL發(fā)送一個(gè)ajax請(qǐng)求.
nonHistorySelectors (string, default: "dialog"):
對(duì)于帶有data-rel屬性值的a標(biāo)簽鏈接 或者 帶有data-role屬性值的page,如果它們匹配這些選擇器(即該string參數(shù)),那么它們不會(huì)在歷史記錄中被追蹤 (即它們不會(huì)在location.hash中被更新也不會(huì)被瀏覽器歷史所標(biāo)記).
activePageClass (string, default: "ui-page-active"):
該class被分配給當(dāng)前視圖中的page (包括過渡狀態(tài)中的)
activeBtnClass (string, default: "ui-page-active"):
該class用于"激活"button的狀態(tài) (參見css框架).
ajaxEnabled (boolean, default: true):
當(dāng)可能的時(shí)候jQuery Mobile 會(huì)自動(dòng)通過ajax處理鏈接點(diǎn)擊以及表單提交, 如果不行,url hash 監(jiān)聽將會(huì)停止,url也會(huì)像常規(guī)那樣發(fā)出HTTP 請(qǐng)求.
ajaxLinksEnabled (boolean, default: true):
只要可行的時(shí)候,jQuery Mobile 就會(huì)自動(dòng)通過ajax處理鏈接的點(diǎn)擊.
ajaxFormsEnabled (boolean, default: true):
只要可行的時(shí)候,jQuery Mobile 就會(huì)自動(dòng)通過ajax處理頁面提交.
autoInitialize (boolean, default: true):
當(dāng)該選項(xiàng)被設(shè)置為false時(shí) 自動(dòng)初始化功能將延遲嵌入頁面(page)的增強(qiáng)功能直到
$.mobile.initializePage();
被顯式調(diào)用. 默認(rèn)情況下當(dāng)DOM加載完畢page將會(huì)被增強(qiáng).
defaultTransition (string, default: 'slide'):
設(shè)置頁面過渡效果(ajax請(qǐng)求),設(shè)置為'none'表示沒有任何過渡效果.
loadingMessage (string, default: "loading"):
設(shè)置頁面加載時(shí)顯示的文本. 如果設(shè)置為false, 將不會(huì)顯示任何文本.
metaViewportContent (string, default: "width=device-width, minimum-scale=1, maximum-scale=1"):
配置自動(dòng)生成的meta標(biāo)簽,如果為false,將不會(huì)為DOM添加任何meta標(biāo)簽.
gradeA (函數(shù)返回boolean值, default: 該函數(shù)默認(rèn)返回 $.support.mediaquery 的值):
瀏覽器必須符合所有支持的條件才會(huì)返回 true.