jQuery Mobile 為行動裝置開發提供了大量專屬事件與方法,從觸控手勢、重力感應到頁面生命週期,都能大幅簡化行動 Web 的互動開發。本文整理了這些特有事件與常用方法,並附上實作心得。
綁定方式很簡單,用 live 或 bind 掛到元素即可:
$('#wlist').live('swipeleft', function(){
changepage('up');
});
orientationchange:當裝置方向在垂直與水平間切換時觸發。回呼函式的第二個參數會帶有 orientation 屬性(portrait 或 landscape),同時這些值也會被加為 HTML 元素的 class,方便在 CSS 中選取。
$('body').live('scrollstop', function(){
$('#hidescroll').val($(this).scrollTop);
});
把位置存進隱藏欄位後,返回頁面時即可還原捲動條位置。
pagebeforeshow、pagebeforehide、pageshow、pagehide 分別在頁面顯示或隱藏的前後觸發,非常適合在載入過程中插入 loading 動畫:
$('div').live('pagebeforeshow', function(){ $.mobile.pageLoading(); });
$('div').live('pageshow', function(){ $.mobile.pageLoading(true); });
pagebeforecreate 與 pagecreate 分別在頁面初始化前後觸發。當你需要依據前頁傳來的資訊初始化新頁面(例如把點擊的檔名帶過去)時,這組事件特別有用。官方範例:
$('#aboutPage').live('pagebeforecreate', function(event){
alert('This page was just inserted into the dom!');
});
$('#aboutPage').live('pagecreate', function(event){
alert('This page was just enhanced by jQuery Mobile!');
});
值得注意的是,jQuery Mobile 會以 Ajax 把對話框等內容當成 div role="page" 加入當前頁,並以 ID 保存其路徑。因此同一連結第二次點擊時其實是顯示已載入的 page,速度很快,但也代表綁定事件時要留意改用 class 而非 id,以免元素已被搬進當前頁而找不到。
顯示或隱藏內建 loading 畫面:
$.mobile.pageLoading(); // 顯示 $.mobile.pageLoading(true); // 隱藏
跳轉頁面:
$.mobile.changePage("about/us.html", "slideup");
$.mobile.changePage({ url: "searchresults.php", type: "get", data: $("form#search").serialize() });
設定捲動位置:
$.mobile.silentScroll(100); // 捲到 Y 100px
此外還有 addResolutionBreakpoints、jqmData、path 等方法,可依官方文件進一步探索。掌握這些事件與方法,就能在行動裝置上交出流暢的使用體驗。