- 文档
- Architectural overview of Cordova platform
- 创建你的第一个App
- Cordova平台支持
- Android平台指南
- Blackberry 10 Guides
- iOS Platform Guide
- OS X 平台指南
- Ubuntu Platform Guide
- Windows Platform Guide
- WP8 Guides
- 平台和插件版本管理
- 自定义app图标(Icon)
- 存储(Storage)
- 隐私指南
- 安全指南
- 白名单指南
- Plugin Development Guide
- Android Plugins
- BlackBerry 10 Plugins
- iOS Plugin Development Guide
- Windows Plugins
- Windows Phone 8 Plugins
- Using Plugman to Manage Plugins
- Embedding WebViews
- Next Steps
- Config.xml
- 事件
- CLI Reference
- Hooks Guide
- Plugin.xml reference documentation
- Battery Status
- Camera
- Console
- Contacts
- Device
- Device Motion
- Device Orientation
- Dialogs
- File
- File Transfer
- Geolocation
- Globalization
- Inappbrowser
- Media
- Media Capture
- Network Information
- Splashscreen
- Vibration
- Statusbar
- Whitelist
- Legacy Whitelist
事件
Cordova给我们提供了很多的事件,可以在应用程序中使用。应用程序代码中可以添加这些事件的监听。例如:
HTML文件
<!DOCTYPE html>
<html>
<head>
<title>Device Ready Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8" src="example.js"></script>
</head>
<body onload="onLoad()">
</body>
</html>
JS文件
// example.js文件
// 等待设备API库加载好
//
function onLoad() {
document.addEventListener("deviceready", onDeviceReady, false);
}
// 设备API可以使用了
//
function onDeviceReady() {
document.addEventListener("pause", onPause, false);
document.addEventListener("resume", onResume, false);
document.addEventListener("menubutton", onMenuKeyDown, false);
//给其他事件添加类似的监听
}
function onPause() {
//处理暂停事件
}
function onResume() {
//处理恢复事件
}
function onMenuKeyDown() {
//处理"菜单"按钮事件
}
// 给其他事件添加类似的事件处理
注意: 应用程序通常一旦deviceready触发就应该用document.addEventListener
绑定事件监听。
下面的表格列除了cordova的事件和支持的平台:
支持的平台/ 事件 | android | blackberry10 | ios | Windows Phone 8 | Windows |
---|---|---|---|---|---|
deviceready | |||||
pause | |||||
resume | |||||
backbutton | |||||
menubutton | |||||
searchbutton | |||||
startcallbutton | |||||
endcallbutton | |||||
volumedownbutton | |||||
volumeupbutton |
deviceready
当Cordova完全加载好deviceready事件会触发。这个事件对每一个应用程序都是必须的。他是Cordova设备API准备好并可以访问的信号。
Cordova由两个代码库组成:原生(native)和JavaScript。一旦原生的代码加载好,自定义的加载图片就可以显示了。然而,JavaScript代码只在DOM加载后加载。这意味这webapp可能在对应的原生代码变得可用之前执行JavaScript方法。
一旦Cordova全部加载deviceready
事件就会触发。一定事件出发,你可以安全的进行CordovaAPI的调用。应用程序通常一旦HTML document DOM加载完成,就会使用 document.addEventListener
绑定一个事件监听。
deviceready
事件和其他事件有点不同。其他事件的事件处理函数注册都是在deviceready
事件出发的回调函数中立马执行。
简单的例子
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
// 现在可以安全的使用设备API
}
pause
当原生平台把应用程序放入后台这个pause事件会触发,通常是用户切换到了不同的应用程序。
简单的例子
document.addEventListener("pause", onPause, false);
function onPause() {
// 处理pause事件
}
iOS的古怪行为
在pause
处理函数中,任何的CordovaAPI调用或者通过Objective-C完成的原生插件他们是不工作的,和任何的交互调用,如alert
和console.log()
是一样的。只有在下一个运行时钟中,app被唤醒才会处理。
iOS的特定resign
事件可作为pause
的替代品,并可以检测用户启动 Lock按钮锁定设备和app在前台运行。如果app(和设备)支持多任务,这个事件了一系列pause
事件是配对出现的,但是仅在iOS5。事实上,在支持多任务的iOS5中,所有被锁的应用程序都被推送到了后台。对于应用程序来说挡在iOS中被锁任然在运行的,让多任务不可用可以设置UIApplicationExitsOnSuspend为YES
。在iOS锁定时运行,这个设置无效。
resume
当原生平台将应用程序从后台运行拉出resume
事件就会触发。
简单的例子
document.addEventListener("resume", onResume, false);
function onResume() {
// 处理resume事件
}
iOS的古怪行为
任何在pause事件处理函数中调用的交互方法都会在app恢复的时候执行,以resume
事件作为信号。包括alerts、console.log()
和其他任何来自插件和CordovaAPId的调用,他们是通过Object-C完成的。
- active 事件
iOS的特定active
事件可作为resume
的替代品,并可以检测用户关闭 Lock按钮解锁设备和app在前台运行。如果app(和设备)支持多任务,这个事件了一系列resume
事件是配对出现的,但是仅在iOS5。事实上,在支持多任务的iOS5中,所有被锁的应用程序都被推送到了后台。对于应用程序来说挡在iOS中被锁任然在运行的,让多任务不可用可以设置UIApplicationExitsOnSuspend为YES
。在iOS锁定时运行,这个设置无效。
resume 事件
当从
resume
事件回掉中调用交互方法,比如:alert()
需要用setTimeout()
时间为0包裹调用,或者其他app挂起。例子:document.addEventListener("resume", onResume, false); function onResume() { setTimeout(function() { // TODO: do your thing! }, 0); }
Android的古怪行为
参考Android生命周期指南来获取关于resume
事件在Android中古怪行为的详细信息。
backbutton(按下返回按钮)
当用户按下返回按钮事件触发,如果你需要重写默写行为你可以注册backbutton
事件监听。不在需要其他调用方法来重写返回按钮的行为。
简单的例子
document.addEventListener("backbutton", onBackKeyDown, false);
function onBackKeyDown() {
// 返回按钮事件的事件处理函数
}
menubutton(按下菜单按钮)
当用户按下菜单按钮事件触发,如果你需要重写默写行为你可以注册menubutton
事件监听。
简单的例子
document.addEventListener("menubutton", onMenuKeyDown, false);
function onMenuKeyDown() {
// 菜单按钮事件的事件处理函数
}
searchbutton(按下搜索按钮)
Android中当用户按下搜索按钮事件触发,如果你需要重写默写行为你可以注册'searchbutton'事件监听。
简单的例子
document.addEventListener("searchbutton", onSearchKeyDown, false);
function onSearchKeyDown() {
// 搜索按钮事件的事件处理函数
}
startcallbutton(按下通话按钮)
当用户按下通话按钮事件触发,如果你需要重写默写行为你可以注册startcallbutton
事件监听。
简单的例子
document.addEventListener("startcallbutton", onStartCallKeyDown, false);
function onStartCallKeyDown() {
// 通话按钮事件的事件处理函数
}
endcallbutton(按下挂断通话按钮)
当用户按下挂断通话按钮事件触发,如果你需要重写默写行为你可以注册endcallbutton
事件监听。
简单的例子
document.addEventListener("endcallbutton", onEndCallKeyDown, false);
function onEndCallKeyDown() {
// 挂断通话按钮事件的事件处理函数
}
volumedownbutton(按下降低声音按钮)
当用户按下降低声音按钮事件触发,如果你需要重写默写行为你可以注册volumedownbutton
事件监听。
简单的例子
document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
function onVolumeDownKeyDown() {
// 降低声音按钮事件的事件处理函数
}
volumeupbutton(按下增加声音按钮)
当用户按下增加声音按钮事件触发,如果你需要重写默写行为你可以注册volumeupbutton
事件监听。
简单的例子
document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
function onVolumeUpKeyDown() {
// 增加声音按钮事件的事件处理函数
}
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论