PhoneGap API介绍:Events

网友投稿 243 2023-05-12

事件类型

backbutton deviceready menubutton pause resume searchbutton online offline

  backbutton

当用户在Android系统上点击后退按钮的时候触发此事件。
复制document.addEventListener("backbutton", yourCallbackFunction, false);  1.

详述

如果你需要在Android系统上重载默认后退按钮的行为,可以通过注册一个事件监听器来监听“backbutton”事件。它不再需求调用任何其他方法来重载后退按钮行为,现在你只需要为“backbutton”事件注册一个事件监听器。 通常情况下,你需要在接收到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台

Android

简单的范例

复制document.addEventListener("backbutton", onBackKeyDown, false);  function onBackKeyDown() {     // 处理后退按钮操作 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 会触发“deviceready”事件      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap is loaded and it is now safe to make calls PhoneGap methods      function onDeviceReady() {          // 注册回退按钮事件监听器             document.addEventListener("backbutton", onBackKeyDown, false);      }      // 处理后退按钮操作      function onBackKeyDown() {      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.

deviceready

当PhoneGap被完全加载后会触发该事件。
复制document.addEventListener("deviceready", yourCallbackFunction, false);  1.

详述

这是每个PhoneGap应用程序都会用到的重要事件。 PhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码加载时会显示一个自定义的加载图片,但是,JavaScript只是在DOM加载后就被加载。这潜在的说明用户的Web应用程序可以在PhoneGap加载完成之前调用相应的JavaScript函数。 PhoneGap一旦完全加载就会触发deviceready事件。当设备触发该事件后,用户就可以安全进行PhoneGap函数调用。 通常情况下,你会希望在HTML文件的DOM加载完毕后使用document.addEventListener附加一个事件监听器。

支持的平台

Android BlackBerry WebWorks (OS 5.0或更高版本) iPhone

简单的范例

复制document.addEventListener("deviceready", onDeviceReady, false);  function onDeviceReady() {      // 现在可以安全使用PhoneGap API 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 就会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法      function onDeviceReady() {         // 现在可以安全使用PhoneGap API      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.

BlackBerry (OS 4.6) 的特异情况

RIM的BrowserField(网页浏览器视图)不支持自定义事件,所以deviceready事件不会被触发。 一种解决方法是一直手动查询PhoneGap.available方法直到PhoneGap完全加载完毕。
复制function onLoad() {      // BlackBerry OS 4浏览器不支持自定义事件。     // 因此通过手动方式等待,直到PhoneGap加载完毕。     var intervalID = window.setInterval(          function() {               if (PhoneGap.available) {               window.clearInterval(intervalID);               onDeviceReady();           }       },       500      );  function onDeviceReady() {      // 现在可以安全地调用PhoneGap API 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.

menubutton

当用户在Android系统上点击菜单按钮的时候触发此事件。
复制document.addEventListener("menubutton", yourCallbackFunction, false);  1.

详述

如果你需要在Android系统上重载默认菜单按钮的行为,可以通过注册一个事件监听器来监听“menubutton”事件。 通常情况下,你需要在接受到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台

Android

简单的范例

复制document.addEventListener("menubutton", onMenuKeyDown, false);  function onMenuKeyDown() {      //处理菜单按钮操作 1.2.3.4.5.

完整的范例

复制<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 会触发“deviceready”事件      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法      function onDeviceReady() {          // 注册菜单按钮事件监听器          document.addEventListener("menubutton", onMenuKeyDown, false);      }      // 处理菜单按钮操作      function onMenuKeyDown() {      }  </script> </head> <bodyonload="onLoad()"> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.

pause

当PhoneGap应用程序被放到后台的时候触发此事件。
复制document.addEventListener("pause", yourCallbackFunction, false);  1.

详述

PhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码将应用程序放到后台的时候会触发pause事件。 通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台

Android BlackBerry WebWorks (OS 5.0或更高版本) iPhone

简单的范例

复制document.addEventListener("pause", onPause, false);  function onPause() {     // 处理pause事件 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数。      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 就会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法      function onDeviceReady() {          document.addEventListener("pause", onPause, false);      }      // 处理pause事件      function onPause() {      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.

iOS的特异情况

在pause事件处理过程中,不但任何通过Objective-C的调用不会工作,而且任何交互性的调用也不会工作,比如警示功能。这意味着你不能调用console.log(及其变种),且任何来自插件或PhoneGap的API的调用都不会有所反应。这些调用只有在应用程序恢复后才会被处理(在下一轮运行循环中处理)。

resume

当PhoneGap应用程序被恢复到前台运行的时候触发此事件。
复制document.addEventListener("resume", yourCallbackFunction, false);  1.

详述

PhoneGap包含两套代码库:本地代码库和JaPhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码将应用程序从后台提取到前台运行的时候触发resume事件。 通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台

Android BlackBerry WebWorks (OS 5.0或更高版本) iPhone

简单的范例

复制document.addEventListener("resume", onResume, false);  function onResume() {     // 处理resume事件 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数。      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 就会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。      function onDeviceReady() {          document.addEventListener("resume", onResume, false);      }      // 处理resume事件      function onResume() {      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.

online

当PhoneGap应用程序在线(连接到因特网)的时候触发此事件。
复制document.addEventListener("online", yourCallbackFunction, false);  1.

详述

当应用程序的网络连接改变为online的时候触发online事件。 通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台

Android BlackBerry WebWorks (OS 5.0或更高版本) iPhone

简单的范例

复制document.addEventListener("online", onOnline, false);  function onOnline() {      // 处理online事件 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数。      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,        // 就会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。      function onDeviceReady() {          document.addEventListener("online", onOnline, false);      }      // 处理online事件      function onOnline() {      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.

iOS的特异情况

在初次启动的情况下,***个online事件(如果有的话)将需要至少1秒钟才被触发。

offline

当PhoneGap应用程序离线(没有连接到因特网)的时候触发此事件。
复制document.addEventListener("offline", yourCallbackFunction, false);  1.

详述

当应用程序的网络连接改变为offline的时候触发offline事件。 通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台

Android BlackBerry WebWorks (OS 5.0或更高版本) iPhone

简单的范例

复制document.addEventListener("offline", onOffline, false);  function onOffline() {      // 处理offline事件 1.2.3.4.5.

完整的范例

复制<!DOCTYPE html> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,        // 就会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);      // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。      function onDeviceReady() {          document.addEventListener("offline", onOffline, false);      }      // 处理offline事件      function onOffline() {      }  </script> </head> <body> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.

iOS的特异情况

在初次启动的情况下,***个offline事件(如果有的话)将需要至少1秒钟才被触发。

Searchbutton

当用户在Android系统上点击搜索按钮的时候触发该事件。
复制document.addEventListener("searchbutton", yourCallbackFunction, false);   1.

详述

如果你需要在Android系统上重载默认搜索按钮的行为,可以通过注册一个事件监听器来监听“searchbutton”事件。 通常情况下,你需要在接受到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台

Android

简单的范例

复制document.addEventListener("searchbutton", onSearchKeyDown, false);  function onSearchKeyDown() {      // 处理搜索按钮操作 1.2.3.4.5.

完整的范例

复制<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <title>PhoneGap Device Ready Example</title> <scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script> <scripttype="text/javascript"charset="utf-8">     // 当PhoneGap加载完毕后调用onDeviceReady回调函数。      // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。      // 当PhoneGap加载完毕并开始和本地设备进行通讯,      // 会触发“deviceready”事件。      document.addEventListener("deviceready", onDeviceReady, false);        // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法      function onDeviceReady() {          // 注册搜索按钮事件监听器          document.addEventListener("searchbutton", onSearchKeyDown, false);      }      // 处理搜索按钮操作      function onSearchKeyDown() {      }  </script> </head> <bodyonload="onLoad()"> </body> </html> 1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:探究DOM API用法
下一篇:Java使用poi组件导出Excel格式数据
相关文章

 发表评论

暂时没有评论,来抢沙发吧~