首页 > 代码库 > jQuery Mobile 页面事件

jQuery Mobile 页面事件

2024-07-02 00:50:09   231人阅读

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 事件处理器

 


联系
我们