jQuery Mobile 為行動裝置補上了一組觸控導向的事件,大致可分為觸摸、滾動、方向與頁面四類。以下依序整理。
觸摸事件:使用者在螢幕上點擊或滑動時觸發。
滾動事件:頁面上下滑動時觸發。
方向事件:裝置垂直或水平旋轉時觸發。
頁面事件:頁面被顯示、隱藏、建立、載入或卸載時觸發。
傳統的 ready 事件,頁面載入完成後執行:
$(document).ready(function(){ //your code here... });
jQuery Mobile 另有 pageinit,在頁面初始化完成後觸發:
$(document).on('pageinit','#pageone',function(){ //your code here... });
事件綁定的通用格式:
$(元素).on('事件',funciton(){ //code here... })
tap:使用者輕點某元素時觸發
taphold:輕點並按住約一秒時觸發
swipe:在某元素上水平滑動超過 30px 時觸發
swipeleft:向左滑動超過 30px 時觸發
swiperight:向右滑動超過 30px 時觸發
scrollstart:使用者開始滾動頁面時觸發(iOS 在滾動期間會凍結 DOM 操作)
scrollstop:使用者停止滾動時觸發
orientationchange:使用者旋轉裝置時觸發。可搭配 window.orientation 判斷目前是直向或橫向:
$(window).on("orientationchange",function(){ if(window.orientation == 0) // Portrait { $("p").css({"background-color":"yellow","font-size":"300%"}); } else // Landscape { $("p").css({"background-color":"pink","font-size":"200%"}); } });
页面事件涵蓋幾個階段:建立前、建立時、初始化後;外部頁面的載入、卸載與失敗;頁面過場的前後;以及頁面切換本身或失敗。
初始化階段
pagebeforecreate:頁面即將初始化,且 jQuery Mobile 尚未開始增強樣式之前
pagecreate:頁面已建立,但增強尚未完成
pageinit:頁面初始化完成,增強作業已結束
$(document).on("pagebeforecreate",function(event){})
載入階段
pagebeforeload:任何頁面載入請求送出之前
pageload:頁面成功載入並插入 DOM 之後
pageloadfailed:載入請求失敗,預設會顯示 "Error Loading Page"
$(document).on("pageload",function(event,data){})
過場階段
pagebeforeshow:在「要去的」頁面觸發,過場動畫開始前
pageshow:在「要去的」頁面觸發,過場動畫結束後
pagebeforehide:在「要離開的」頁面觸發,過場動畫開始前
pagehide:在「要離開的」頁面觸發,過場動畫結束後
$(document).on("pagebeforeshow","#pagetwo",function(){ })
實務上最常用的是 pageinit 與 pageshow:前者適合做一次性初始化,後者每次頁面顯示都會觸發,適合刷新需要重算的內容。要留意的是,jQuery Mobile 已進入維護狀態,新專案若無維護既有程式碼的需求,評估其他行動端方案會更合適。