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