jQuery Mobile 页面事件
在 jQuery Mobile 中与页面打交道的事件被分为四类:
- Page Initialization - 在页面创建前,当页面创建时,以及在页面初始化之后
- Page Load/Unload - 当外部页面加载时、卸载时或遭遇失败时
- Page Transition - 在页面过渡之前和之后
- Page Change - 当页面被更改,或遭遇失败时
jQuery Mobile Initialization 事件
当 jQuery Mobile 中的一张典型页面进行初始化时,它会经历三个阶段:
- 在页面创建前
- 页面创建
- 页面初始化
每个阶段触发的事件都可用于插入或操作代码。
事件 | 描述 |
---|---|
pagebeforecreate | 当页面即将初始化,并且在 jQuery Mobile 已开始增强页面之前,触发该事件。 |
pagecreate | 当页面已创建,但增强完成之前,触发该事件。 |
pageinit | 当页面已初始化,并且在 jQuery Mobile 已完成页面增强之后,触发该事件。 |
下面的例子演示在 jQuery Mobile 中创建页面时,何时触发每种事件:
$(document).on("pagebeforecreate",function(event){ alert("触发 pagebeforecreate 事件!"); }); $(document).on("pagecreate",function(event){ alert("触发 pagecreate 事件!"); }); $(document).on("pageinit",function(event){ alert("触发 pageinit 事件!") });
jQuery Mobile Load 事件
页面加载事件属于外部页面。
无论外部页面何时载入 DOM,将触发两个事件。第一个是 pagebeforeload,第二个是 pageload (成功)或 pageloadfailed(失败)。
下表中解释了这些事件:
事件 | 描述 |
---|---|
pagebeforeload | 在任何页面加载请求作出之前触发。 |
pageload | 在页面已成功加载并插入 DOM 后触发。 |
pageloadfailed | 如果页面加载请求失败,则触发该事件。默认地,将显示 "Error Loading Page" 消息。 |
下列演示 pageload 和 pagloadfailed 事件的工作原理:
$(document).on("pageload",function(event,data){ alert("触发 pageload 事件! URL: " + data.url); }); $(document).on("pageloadfailed",function(event,data){ alert("抱歉,被请求页面不存在。"); });
jQuery Mobile 过渡事件
我们还可以在从一页过渡到下一页时使用事件。
页面过渡涉及两个页面:一张“来”的页面和一张“去”的页面 - 这些过渡使当前活动页面(“来的”页面)到新页面(“去的”页面的改变过程变得更加动感。
事件 | 描述 |
---|---|
pagebeforeshow | 在“去的”页面触发,在过渡动画开始前。 |
pageshow | 在“去的”页面触发,在过渡动画完成后。 |
pagebeforehide | 在“来的”页面触发,在过渡动画开始前。 |
pagehide | 在“来的”页面触发,在过渡动画完成后。 |
下列演示了过渡时间的工作原理:
$(document).on("pagebeforeshow","#pagetwo",function(){ // 当进入页面二时 alert("页面二即将显示"); }); $(document).on("pageshow","#pagetwo",function(){ // 当进入页面二时 alert("现在显示页面二"); }); $(document).on("pagebeforehide","#pagetwo",function(){ // 当离开页面二时 alert("页面二即将隐藏"); }); $(document).on("pagehide","#pagetwo",function(){ // 当离开页面二时 alert("现在隐藏页面二"); });
jQuery Mobile 事件参考手册
下表列出了所有的 jQuery Mobile 事件。
注释:请通过使用 on() 方法来绑定事件。
事件 | 描述 |
---|---|
hashchange | 启用 bookmarkable #hash 历史记录。 |
navigate | 针对 hashchange 和 popstate 的 wrapper 事件。 |
orientationchange | 当用户垂直或水平旋转其移动设备时触发。 |
pagebeforechange | 在页面变化周期内触发两次:任意页面加载或过渡之前触发一次,接下来在页面成功完成加载后,但是在浏览器历史记录被导航进程修改之前触发。 |
pagebeforecreate | 当页面即将被初始化,但是在增强开始之前触发。 |
pagebeforehide | 在过渡动画开始前,在“来源”页面上触发。 |
pagebeforeload | 在作出任何加载请求之前触发。 |
pagebeforeshow | 在过渡动画开始前,在“到达”页面上触发。 |
pagechange | 在 changePage() 请求已完成将页面载入 DOM 并且所有页面过渡动画已完成后触发。 |
pagechangefailed | 当 changePage() 请求对页面的加载失败时触发。 |
pagecreate | 当页面已创建,但是增强完成之前触发。 |
pagehide | 在过渡动画完成后,在“来源”页面触发。 |
pageinit | 当页面已经初始化并且完成增强时触发。 |
pageload | 在页面成功加载并插入 DOM 后触发。 |
pageloadfailed | 如果页面加载请求失败,则触发。 |
pageremove | 在窗口视图从 DOM 中移除外部页面之前触发。 |
pageshow | 在过渡动画完成后,在“到达”页面触发。 |
scrollstart | 当用户开始滚动页面时触发。 |
scrollstop | 当用户停止滚动页面时触发。 |
swipe | 当用户在元素上水平滑动时触发。 |
swipeleft | 当用户从左划过元素超过 30px 时触发。 |
swiperight | 当用户从右划过元素超过 30px 时触发。 |
tap | 当用户敲击某元素时触发。 |
taphold | 当元素敲击某元素并保持一秒时触发。 |
throttledresize | 启用 bookmarkable #hash 历史记录 |
updatelayout | 由动态显示/隐藏内容的 jQuery Mobile 组件触发。 |
vclick | 虚拟化的 click 事件处理器 |
vmousecancel | 虚拟化的 mousecancel 事件处理器 |
vmousedown | 虚拟化的 mousedown 事件处理器 |
vmousemove | 虚拟化的 mousemove 事件处理器 |
vmouseout | 虚拟化的 mouseout 事件处理器 |
vmouseover | 虚拟化的 mouseover 事件处理器 |
vmouseup | 虚拟化的 mouseup 事件处理器 |