jQuery Mobile 页面事件
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 事件！\nURL: " + 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 事件处理器 |
