Cordova事件
Cordova框架了一组事件,开发者用来对某些运行Cordova应用的设备上的事件作出反应。事件处理的一种情况是硬件相关活动,如电池状态变化或用户按了某个物理按钮;另一种情况是应用程序状态的变化,如应用被中止或恢复。这些web应用使用的事件同Native应用使用的是一样的。
完整的支持的事件列表如下:
Cordova 事件 | 描述 |
backbutton | 用户按设备后退键时触发 |
batterycritical | 电池达到关键状态时触发。关键状态的定义因平台而异 |
batterylow | 电池低电量状态时触发。低电量状态的定义因平台而异 |
batterystatus | 电池状态至少改变1%时时触发(增加或减少) |
deviceready | cordova容器完成初始化时触发 |
endcallbutton | 在用户按手机的结束通话键时触发 |
menubutton | 在用户按手机的菜单键时触发 |
offline | 在设备失去网络连接时触发 |
online | 在设备由没有网络连接转换到连接状态时触发 |
pause | Cordova应用被挂起时触发。一般发生在用户跳转到另一个应用,系统把当前应用放在后台时 |
resume | 在被挂起的应用转到前台时触发 |
searchbutton | 在用户按查找键时触发 |
startcallbutton | 在用户按通话键时触发 |
volumedownbutton | 用户按音量减少键时触发 |
volumnupbutton | 用户按音量键增加时触发 |
老式手机使用物理按钮来拨通和结束通话。在较新的设备上,这些按钮被移除并用虚拟按键代替。虚拟按键只在用到(如菜单和查找按键),或只用于某些应用(像电话按键)。
大多数的列出的事件都在Cordova容器中实现了。只有电池状态以插件形式实现了。要使应用能够监视电池事件必须首先添加电池状态插件:
cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin=battery-status.git
其中device事件在《cordova应用解析》讨论过。
要监视这些事件可以简单的在应用中为某个事件注册监听器。
document.addEventListener("eventName", eventFunction);
如要监听是否断开网络连接,可以注册offline事件的监听器:
-
document.addEventListener("offline", isOffline);
-
function isOffline() {
-
// 断开网络连接时的动作
-
}
事件在不同的移动平台上并不都准确的按期望的情况触发,需要在不同设备上测试确保应用按期望的工作。
测试过的事件如下:
-
/********Cordova事件绑定******/
-
document.addEventListener('backbutton', function () {
-
console.info("后退键被点击");
-
}, false);
-
document.addEventListener('deviceready', function () {
-
console.info("cordova容器完成初始化时触发");
-
}, false);
-
document.addEventListener('menubutton', function () {
-
console.info("在用户按手机的菜单键时触发");
-
}, false);
-
document.addEventListener('pause', function () {
-
console.info("Cordova应用被挂起时触发");
-
}, false);
-
document.addEventListener('resume', function () {
-
console.info("在被挂起的应用转到前台时触发");
-
}, false);
-
document.addEventListener('startcallbutton', function () {
-
console.info("在用户按通话键时触发");
-
}, false);