现在的位置: 首页 > 综合 > 正文

PhoneGap API介绍：Events

2013年10月18日 ⁄ 综合 ⁄ 共 2876字 ⁄ 字号 小 中 大 ⁄ 评论关闭

事件类型：

backbutton

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

详述：

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

支持的平台：

  • Android

简单的范例：

  1. document.addEventListener("backbutton", onBackKeyDown, false); 
  2.      
  3. function onBackKeyDown() { 
  4.    // 处理后退按钮操作 
  5. } 

完整的范例：

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>PhoneGap Device Ready Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"> 
  8.  
  9.     // 当PhoneGap加载完毕后调用onDeviceReady回调函数 
  10.     // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。 
  11.     // 当PhoneGap加载完毕并开始和本地设备进行通讯， 
  12.     // 会触发“deviceready”事件 
  13.     document.addEventListener("deviceready", onDeviceReady, false); 
  14.      
  15.     // PhoneGap is loaded and it is now safe to make calls PhoneGap methods 
  16.     function onDeviceReady() { 
  17.         // 注册回退按钮事件监听器 
  18.            document.addEventListener("backbutton", onBackKeyDown, false); 
  19.     } 
  20.      
  21.     // 处理后退按钮操作 
  22.     function onBackKeyDown() { 
  23.     } 
  24.  
  25. </script> 
  26. </head> 
  27. <body> 
  28. </body> 
  29. </html> 

deviceready

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

详述：

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

支持的平台：

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

简单的范例：

  1. document.addEventListener("deviceready", onDeviceReady, false); 
  2.  
  3. function onDeviceReady() { 
  4.     // 现在可以安全使用PhoneGap API 
  5. } 

完整的范例：

  1. <!DOCTYPE html> 
  2. <html> 
  3. <head>     
  4. <title>PhoneGap Device Ready Example</title> 
  5.  
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  7. <script type="text/javascript" charset="utf-8"> 
  8.  
  9.     // 当PhoneGap加载完毕后调用onDeviceReady回调函数 
  10.     // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。 
  11.     // 当PhoneGap加载完毕并开始和本地设备进行通讯， 
  12.     // 就会触发“deviceready”事件。 
  13.     document.addEventListener("deviceready", onDeviceReady, false); 
  14.      
  15.     // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法 
  16.     function onDeviceReady() { 
  17.        // 现在可以安全使用PhoneGap API 
  18.     } 
  19.  
  20. </script> 
  21. </head> 
  22. <body> 
  23. </body> 
  24. </html> 

BlackBerry (OS 4.6) 的特异情况：

  • RIM的BrowserField(网页浏览器视图)不支持自定义事件，所以deviceready事件不会被触发。
  • 一种解决方法是一直手动查询PhoneGap.available方法直到PhoneGap完全加载完毕。
    

  1. function onLoad() { 
    2. 

  2.     // BlackBerry OS 4浏览器不支持自定义事件。 
    3. 

  3.     // 因此通过手动方式等待，直到PhoneGap加载完毕。 
    4. 

  4.     var intervalID = window.setInterval( 
    5. 

  5.         function() { 
    6. 

  6.              if (PhoneGap.available) { 
    7. 

  7.              window.clearInterval(intervalID); 
    8. 

  8.              onDeviceReady(); 
    9. 

  9.          } 
    10. 

  10.      }, 
    11. 

  11.      500 
    12. 

  12.     ); 
    13. 

  13. } 
    14. 

  14.  
    15. 

  15. function onDeviceReady() { 
    16. 

  16.     // 现在可以安全地调用PhoneGap API 
    17. 

  17. } 
返回
【上篇】
【下篇】

作者:

抱歉!评论已关闭.

返回首页

Copyright © 2013-2018 学步园  保留所有权利.
软文销售 QQ客服：2265327166 点击这里给我发消息（其他合作也可洽谈）
必威体育
必威电竞