PhoneGapAPI帮助文档翻译整理7Events 消息Word下载.docx

1、如果你需要在android系统上重载缺省后退按钮的行为,你可以通过注册backbutton事件监听来达到这一目的,目前已经不需要为了重载后退按钮的行为而去调用其他任何方法。现在，你只需为事件注册一个事件监听器就可以了通常情况下,你需要在接收到deviceready消息后，使用document.addEventListener来建立这个时间的监听器支持的平台 android 简单的例子, onBackKeyDown, false）;functiononBackKeyDown（） / Handle the back buton完整的例子htmlheadtitlePhoneGap Device Re

2、ady Examplescript type=text/javascript charset=utf-8 src=phonegap.js/script / Call onDeviceReady when PhoneGap is loaded. / 当PhoneGap加载完毕后调用onDeviceReady / At this point, the document has loaded but phonegap.js has not. / When PhoneGap is loaded and talking with the native device, / it will call the

3、 event deviceready. / 现在这个时候，文档已经加载完毕，但是phonegap.js还没有加载完毕 / 当PhoneGap加载完毕并且与原生设备并连接上后,phonegap会触发消息functiononLoad（） deviceready, onDeviceReady, false）; / PhoneGap is loaded and it is now safe to make calls PhoneGap methods / PhoneGap加载完毕,现在已经可以安全的调用PhoneGap的方法functiononDeviceReady（） / Register the

4、event listener / 注册时间监听器 / Handle the back button / 处理后退的动作/headbody onload=onLoad（）/body/htmldeviceready只有当PhoneGap被完全加载后这个消息才被发出对于任何一个PhoneGap应用程序来说，这个消息都十分重要，是你一定要使用的PhoneGap包含两套代码库:原生代码库以及JavaScript代码库.当原生代码加载的时候，表示正在加载的图片会被现实出来。不过，JavaScript一旦DOM加载，JAVASCRIPT也会加载.这就是说你的WEB应用程序有一定的可能性在PhoneGap原生

5、库加载完毕之前就可以调用一个PhoneGap JavaScript函数PhoneGap一旦完成加载就会发出一个deviceready消息.当设备发出这个消息后，你就可以很安全的调用PhoneGap的函数了一般来说，你应当在HTML documents DOM加载时使用document.addEventListener为系统增加一个消息监听器 Android BlackBerry WebWorks （OS 5.0 and higher） iPhone / Now safe to use the PhoneGap API/ 现在使用PhoneGap API就安全了 / 这个时候,文档已经加载完毕，

6、但是phonegap.js还没有加载完毕 / PhoneGap加载完毕并且可以安全调用PhoneGap的方法 / 现在可以安全的使用PhoneGap的APIBlackBerry （OS 4.6） 的独特之处RIM的（web浏览器视图）BrowserField不支持自定义消息，所以deviceready不会被触发一个解决方法是手动查询PhoneGap.available，直到PhoneGap已经完全加载。 / BlackBerry OS 4 browser does not support events. / So, manually wait until PhoneGap is availab

7、le. / BlackBerry OS 4浏览器不支持这个消息 / 因此我们用手动方式等待，直到PhoneGap加载完毕varintervalID = window.setInterval（function（） if （PhoneGap.available） window.clearInterval（intervalID）;onDeviceReady（）; , 500 ）; / 现在可以安全的使用PhoneGap APImenubutton当用户在Android系统上点击菜单按钮的时候触发此事件。view plaincopy to clipboardprint?menubutton 详述如果你

8、需要在Android系统上重载默认菜单按钮的行为，可以通过注册一个事件监听器来监听“menubutton”事件。通常情况下，你需要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。 Android简单的范例, onMenuKeyDown, false）;functiononMenuKeyDown（） /处理菜单按钮操作 完整的范例/ 当PhoneGap加载完毕后调用onDeviceReady回调函数 / 此时，该文件已加载完毕但phonegap.js还没有加载完毕。/ 当PhoneGap加载完毕并开始和本地设备

9、进行通讯， / 会触发“deviceready”事件 / PhoneGap加载完毕，现在可以安全地调用PhoneGap方法 functiononDeviceReady（） / 注册菜单按钮事件监听器 / 处理菜单按钮操作 pause当PhoneGap程序被放到后台的时候触发此事件pausePhoneGap基于两种代码：原生以及javascript。当原生代码将应用程序放到后台的时候,暂停时间被触发。通常情况下,你需要在接收到PhoneGap的消息后，使用document.addEventListener增加一个事件监听器支持的平台:简单的例子:, onPause, false）;functio

10、nonPause（） / Handle the pause event / 处理暂停事件完整的例子: / PhoneGap已经加载完毕，并且现在已经可以安全的调用PhoneGap的方法了iOS的特别之处在暂停事件处理过程中,任何对Objective-C的调用都不会工作。任何调用也不会产生交互，例如alerts。这意味着你不能调用console.log（及其变种）,任何插件的调用或者PhoneGap API的调用也不会有所动作。这些调用将在应用等程序回复的时候被处理（在下一次运行的时候处理） resume当应用程序从后台回复到前台运行的时候触发此事件resume, onResume, false

11、）;functiononResume（） / Handle the resume event / 处理恢复事件online当PhoneGap应用程序在线（连接到因特网）的时候触发此事件。online当应用程序的网络连接改变为online的时候触发online事件。通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。 BlackBerry WebWorks （OS 5.0或更高版本） iPhone, onOnline, false）;function onOnline（） / 处理online事

12、件 完整的范例：DOCTYPE html/ 当PhoneGap加载完毕后调用onDeviceReady回调函数。/ 就会触发“deviceready”事件。/ PhoneGap加载完毕，现在可以安全地调用PhoneGap方法。function onDeviceReady（） bodyiOS的特异情况在初次启动的情况下，第一个online事件（如果有的话）将需要至少1秒钟才被触发。offline当PhoneGap应用程序离线（没有连接到因特网）的时候触发此事件。offline当应用程序的网络连接改变为offline的时候触发offline事件。, onOffline, false）;functiononOffline（） / 处理offline事件 PhoneGap Device Re