51CTO首页
AI.x社区
博客
学堂
精品班
软考社区
免费课
企业培训
鸿蒙开发者社区
WOT技术大会
IT证书
公众号矩阵
移动端
短视频免费课程课程排行直播课软考学堂
全部课程厂商认证IT技术25年5月软考PMP项目管理免费题库
在线学习
文章资源问答课堂专栏直播
51CTO
鸿蒙开发者社区
51CTO技术栈
51CTO官微
51CTO学堂
51CTO博客
CTO训练营
鸿蒙开发者社区订阅号
51CTO软考
51CTO学堂APP
51CTO学堂企业版APP
鸿蒙开发者社区视频号
51CTO软考题库
账号设置 退出

解析PhoneGap API帮助文档翻译Events事件

作者：佚名
移动开发
PhoneGap API帮助文档翻译Events事件是本文要介绍的内容，主要是来了解并学习PhoneGap API文档的应用，具体关于PhoneGap API文档的翻译来看本文详解。

PhoneGap API帮助文档翻译Events事件是本文要介绍的内容，主要是来了解并学习PhoneGap API文档的应用，具体关于PhoneGap API文档的翻译来看本文详解，PhoneGap整个生命周期内触发的事件。

事件类型：

  1. backbutton  
  2. deviceready  
  3. menubutton  
  4. pause  
  5. resume  
  6. searchbutton  
  7. online  
  8. offline  
  9. backbutton   

当用户在Android系统上点击后退按钮的时候触发此事件。

  1. document.addEventListener("backbutton", yourCallbackFunction, false);    
  2. 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. }    
  6. document.addEventListener("backbutton", onBackKeyDown, false);  
  7.    
  8. function onBackKeyDown() {  
  9.    // 处理后退按钮操作  
  10. } 

完整的范例：

  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>    
  30. <!DOCTYPE html> 
  31. <html> 
  32. <head>   
  33. <title>PhoneGap Device Ready Example</title> 
  34.  
  35. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  36. <script type="text/javascript" charset="utf-8"> 
  37.  
  38.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数   
  39.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  40.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  41.  // 会触发“deviceready”事件  
  42.  document.addEventListener("deviceready", onDeviceReady, false);  
  43.    
  44.  // PhoneGap is loaded and it is now safe to make calls PhoneGap methods  
  45.  function onDeviceReady() {  
  46.   // 注册回退按钮事件监听器  
  47.      document.addEventListener("backbutton", onBackKeyDown, false);  
  48.  }  
  49.    
  50.  // 处理后退按钮操作  
  51.  function onBackKeyDown() {  
  52.  }  
  53.  
  54. </script> 
  55. </head> 
  56. <body> 
  57. </body> 
  58. </html> 
  59. deviceready   

当PhoneGap被完全加载后会触发该事件。

  1. document.addEventListener("deviceready", yourCallbackFunction, false);    
  2. 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. function onDeviceReady() {    
  3.     // 现在可以安全使用PhoneGap API     
  4. }    
  5. document.addEventListener("deviceready", onDeviceReady, false);  
  6.  
  7. function onDeviceReady() {  
  8.  // 现在可以安全使用PhoneGap API   
  9. } 

完整的范例：

  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>    
  25. <!DOCTYPE html> 
  26. <html> 
  27. <head>   
  28. <title>PhoneGap Device Ready Example</title> 
  29.  
  30. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  31. <script type="text/javascript" charset="utf-8"> 
  32.  
  33.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
  34.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  35.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  36.  // 就会触发“deviceready”事件。  
  37.  document.addEventListener("deviceready", onDeviceReady, false);  
  38.    
  39.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法  
  40.  function onDeviceReady() {  
  41.     // 现在可以安全使用PhoneGap API  
  42.  }  
  43.  
  44. </script> 
  45. </head> 
  46. <body> 
  47. </body> 
  48. </html> 

#p#

BlackBerry (OS 4.6) 的特异情况：

RIM的BrowserField(网页浏览器视图)不支持自定义事件，所以deviceready事件不会被触发。

PhoneGap API中，一种解决方法是一直手动查询PhoneGap.available方法直到PhoneGap完全加载完毕。

  1. function onLoad() {    
  2.     // BlackBerry OS 4浏览器不支持自定义事件。    
  3.     // 因此通过手动方式等待，直到PhoneGap加载完毕。    
  4.     var intervalID = window.setInterval(    
  5.         function() {    
  6.             if (PhoneGap.available) {    
  7.             window.clearInterval(intervalID);    
  8.             onDeviceReady();    
  9.         }    
  10.     },    
  11.     500    
  12.     );    
  13. }    
  14.     
  15. function onDeviceReady() {    
  16.     // 现在可以安全地调用PhoneGap API    
  17. }    
  18. function onLoad() {  
  19.  // BlackBerry OS 4浏览器不支持自定义事件。  
  20.  // 因此通过手动方式等待，直到PhoneGap加载完毕。  
  21.  var intervalID = window.setInterval(  
  22.   function() {  
  23.     if (PhoneGap.available) {  
  24.     window.clearInterval(intervalID);  
  25.     onDeviceReady();  
  26.    }  
  27.   },  
  28.   500  
  29.  );  
  30. }  
  31.  
  32. function onDeviceReady() {  
  33.  // 现在可以安全地调用PhoneGap API  
  34. } 

menubutton 

当用户在Android系统上点击菜单按钮的时候触发此事件。

  1. document.addEventListener("menubutton", yourCallbackFunction, false);    
  2. document.addEventListener("menubutton", yourCallbackFunction, false); 

详述：

如果你需要在Android系统上重载默认菜单按钮的行为，可以通过注册一个事件监听器来监听“menubutton”事件。

通常情况下，你需要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。

支持的平台：

Android

简单的范例：

  1. document.addEventListener("menubutton", onMenuKeyDown, false);     
  2.      
  3. function onMenuKeyDown() {     
  4.     //处理菜单按钮操作     
  5. }    
  6. document.addEventListener("menubutton", onMenuKeyDown, false);   
  7.    
  8. function onMenuKeyDown() {   
  9.  //处理菜单按钮操作   
  10. } 

完整的范例：

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">    
  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.         // 注册菜单按钮事件监听器    
  18.         document.addEventListener("menubutton", onMenuKeyDown, false);     
  19.     }     
  20.         
  21.     // 处理菜单按钮操作    
  22.     function onMenuKeyDown() {     
  23.     }     
  24.     
  25. </script>    
  26. </head>    
  27. <body onload="onLoad()">    
  28. </body>    
  29. </html>    
  30. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 
  31. <html> 
  32. <head>   
  33. <title>PhoneGap Device Ready Example</title>   
  34.  
  35. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
  36. <script type="text/javascript" charset="utf-8">   
  37.  
  38.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
  39.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  40.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  41.  // 会触发“deviceready”事件  
  42.  document.addEventListener("deviceready", onDeviceReady, false);   
  43.    
  44.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法  
  45.  function onDeviceReady() {   
  46.   // 注册菜单按钮事件监听器  
  47.   document.addEventListener("menubutton", onMenuKeyDown, false);   
  48.  }   
  49.    
  50.  // 处理菜单按钮操作  
  51.  function onMenuKeyDown() {   
  52.  }   
  53.  
  54. </script> 
  55. </head> 
  56. <body onload="onLoad()"> 
  57. </body> 
  58. </html> 
  59. pause   

#p#

当PhoneGap应用程序被放到后台的时候触发此事件。

  1. document.addEventListener("pause", yourCallbackFunction, false);    
  2. document.addEventListener("pause", yourCallbackFunction, false); 

详述：

PhoneGap API中，PhoneGap包含两套代码库：本地代码库和JavaScript代码库。当本地代码将应用程序放到后台的时候会触发pause事件。

通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。
支持的平台：

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例：

  1. document.addEventListener("pause", onPause, false);    
  2.     
  3. function onPause() {    
  4.    // 处理pause事件    
  5. }    
  6. document.addEventListener("pause", onPause, false);  
  7.  
  8. function onPause() {  
  9.    // 处理pause事件  
  10. } 

完整的范例：

  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.         document.addEventListener("pause", onPause, false);    
  18.     }    
  19.         
  20.     // 处理pause事件    
  21.     function onPause() {    
  22.     }    
  23.     
  24. </script>    
  25. </head>    
  26. <body>    
  27. </body>    
  28. </html>    
  29. <!DOCTYPE html> 
  30. <html> 
  31. <head>   
  32. <title>PhoneGap Device Ready Example</title> 
  33.  
  34. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  35. <script type="text/javascript" charset="utf-8"> 
  36.    
  37.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
  38.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  39.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  40.  // 就会触发“deviceready”事件。  
  41.  document.addEventListener("deviceready", onDeviceReady, false);  
  42.    
  43.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法  
  44.  function onDeviceReady() {  
  45.   document.addEventListener("pause", onPause, false);  
  46.  }  
  47.    
  48.  // 处理pause事件  
  49.  function onPause() {  
  50.  }  
  51.  
  52. </script> 
  53. </head> 
  54. <body> 
  55. </body> 
  56. </html> 

iOS的特异情况：

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

resume  
 
当PhoneGap应用程序被恢复到前台运行的时候触发此事件。

  1. document.addEventListener("resume", yourCallbackFunction, false);    
  2. document.addEventListener("resume", yourCallbackFunction, false); 

详述：

PhoneGap API中，PhoneGap包含两套代码库：本地代码库和JaPhoneGap包含两套代码库：本地代码库和JavaScript代码库。当本地代码将应用程序从后台提取到前台运行的时候触发resume事件。

通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例：

  1. document.addEventListener("resume", onResume, false);    
  2.     
  3. function onResume() {    
  4.    // 处理resume事件    
  5. }    
  6. document.addEventListener("resume", onResume, false);  
  7.  
  8. function onResume() {  
  9.    // 处理resume事件  
  10. } 

完整的范例

  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.         document.addEventListener("resume", onResume, false);    
  18.     }    
  19.         
  20.     // 处理resume事件    
  21.     function onResume() {    
  22.     }    
  23.         
  24. </script>    
  25. </head>    
  26. <body>    
  27. </body>    
  28. </html>    
  29. <!DOCTYPE html> 
  30. <html> 
  31. <head>   
  32. <title>PhoneGap Device Ready Example</title> 
  33.  
  34. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
  35. <script type="text/javascript" charset="utf-8"> 
  36.  
  37.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
  38.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  39.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  40.  // 就会触发“deviceready”事件。  
  41.  document.addEventListener("deviceready", onDeviceReady, false);  
  42.    
  43.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法。  
  44.  function onDeviceReady() {  
  45.   document.addEventListener("resume", onResume, false);  
  46.  }  
  47.    
  48.  // 处理resume事件  
  49.  function onResume() {  
  50.  }  
  51.    
  52. </script> 
  53. </head> 
  54. <body> 
  55. </body> 
  56. </html> 
  57. online   

#p#

当PhoneGap应用程序在线（连接到因特网）的时候触发此事件。

  1. document.addEventListener("online", yourCallbackFunction, false);    
  2. document.addEventListener("online", yourCallbackFunction, false); 

详述：

当应用程序的网络连接改变为online的时候触发online事件。

通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例：

  1. document.addEventListener("online", onOnline, false);     
  2.      
  3. function onOnline() {    
  4.     // 处理online事件    
  5. }    
  6. document.addEventListener("online", onOnline, false);   
  7.    
  8. function onOnline() {  
  9.  // 处理online事件  
  10. }  

完整的范例：

  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.         document.addEventListener("online", onOnline, false);     
  18.     }     
  19.         
  20.     // 处理online事件     
  21.     function onOnline() {     
  22.     }     
  23.     
  24. </script>    
  25. </head>    
  26. <body>    
  27. </body>    
  28. </html>    
  29. <!DOCTYPE html> 
  30. <html> 
  31. <head>   
  32. <title>PhoneGap Device Ready Example</title>   
  33.  
  34. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
  35. <script type="text/javascript" charset="utf-8">   
  36.  
  37.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
  38.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  39.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  40.    // 就会触发“deviceready”事件。  
  41.  document.addEventListener("deviceready", onDeviceReady, false);   
  42.    
  43.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法。  
  44.  function onDeviceReady() {   
  45.   document.addEventListener("online", onOnline, false);   
  46.  }   
  47.    
  48.  // 处理online事件   
  49.  function onOnline() {   
  50.  }   
  51. </script> 
  52. </head> 
  53. <body> 
  54. </body> 
  55. </html> 

iOS的特异情况：

在初次启动的情况下，第一个online事件（如果有的话）将需要至少1秒钟才被触发。

offline 

当PhoneGap应用程序离线（没有连接到因特网）的时候触发此事件。

  1. document.addEventListener("offline", yourCallbackFunction, false);    
  2. document.addEventListener("offline", yourCallbackFunction, false); 

详述：

当应用程序的网络连接改变为offline的时候触发offline事件。

通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例：

  1. document.addEventListener("offline", onOffline, false);     
  2.      
  3. function onOffline() {    
  4.     // 处理offline事件     
  5. }    
  6. document.addEventListener("offline", onOffline, false);   
  7.    
  8. function onOffline() {  
  9.  // 处理offline事件   
  10. } 

完整的范例：

  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.         document.addEventListener("offline", onOffline, false);     
  18.     }     
  19.         
  20.     // 处理offline事件    
  21.     function onOffline() {     
  22.     }     
  23.     
  24. </script>    
  25. </head>    
  26. <body>    
  27. </body>    
  28. </html>    
  29. <!DOCTYPE html> 
  30. <html> 
  31. <head>   
  32. <title>PhoneGap Device Ready Example</title>   
  33.  
  34. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
  35. <script type="text/javascript" charset="utf-8">   
  36.  
  37.  // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
  38.  // 此时，该文件已加载完毕但phonegap.js还没有加载完毕。  
  39.  // 当PhoneGap加载完毕并开始和本地设备进行通讯，  
  40.    // 就会触发“deviceready”事件。  
  41.  document.addEventListener("deviceready", onDeviceReady, false);   
  42.    
  43.  // PhoneGap加载完毕，现在可以安全地调用PhoneGap方法。  
  44.  function onDeviceReady() {   
  45.   document.addEventListener("offline", onOffline, false);   
  46.  }   
  47.    
  48.  // 处理offline事件  
  49.  function onOffline() {   
  50.  }   
  51.  
  52. </script> 
  53. </head> 
  54. <body> 
  55. </body> 
  56. </html> 

iOS的特异情况：

在初次启动的情况下，第一个offline事件（如果有的话）将需要至少1秒钟才被触发。

Searchbutton  
 
当用户在Android系统上点击搜索按钮的时候触发该事件。

  1. document.addEventListener("searchbutton", yourCallbackFunction, false);    
  2. document.addEventListener("searchbutton", yourCallbackFunction, false); 

详述：

如果你需要在Android系统上重载默认搜索按钮的行为，可以通过注册一个事件监听器来监听“searchbutton”事件。

通常情况下，你需要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。

支持的平台：

Android

简单的范例：

  1. document.addEventListener("searchbutton", onSearchKeyDown, false);     
  2.      
  3. function onSearchKeyDown() {    
  4.     // 处理搜索按钮操作    
  5. }    
  6. document.addEventListener("searchbutton", onSearchKeyDown, false);   
  7.    
  8. function onSearchKeyDown() {  
  9.  // 处理搜索按钮操作  
  10. } 

完整的范例：

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">    
  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.         // 注册搜索按钮事件监听器    
  18.         document.addEventListener("searchbutton", onSearchKeyDown, false);     
  19.     }     
  20.         
  21.     // 处理搜索按钮操作    
  22.     function onSearchKeyDown() {     
  23.     }     
  24.     
  25. </script>    
  26. </head>    
  27. <body onload="onLoad()">    
  28. </body>    
  29. </html>   

小结：解析PhoneGap API帮助文档翻译Events事件的内容介绍完了，希望通过PhoneGap API内容的学习能对你有所帮助！

责任编辑：zhaolei 来源： CSDN博客
PhoneGap API
相关推荐
解析PhoneGap API帮助文档翻译Storage存储
PhoneGapAPI帮助文档翻译Storage存储是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的内容，具体关于PhoneGapAPI文档内容的详解来看本文。

2011-09-13 14:07:45

PhoneGap AP
解析PhoneGap API帮助文档翻译Connection连接
PhoneGapAPI帮助文档翻译Connection连接是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的翻译，具体来看本文详解。

2011-09-13 11:06:08

PhoneGap AP
解析PhoneGap API帮助文档翻译Device设备
PhoneGapAPI帮助文档翻译Device设备是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的翻译，具体内容的实现来看本文详解。

2011-09-13 10:40:25

PhoneGap AP
PhoneGap API帮助文档翻译Media媒体
PhoneGapAPI帮助文档翻译Media媒体是本文要介绍的内容。，主要是来了解并学习PhoneGapAPI文档的内容，具体关于PhoneGapAPI文档内容的详解来看本文。

2011-09-13 14:40:16

PhoneGap AP
PhoneGap API帮助文档翻译Capture采集
PhoneGapAPI帮助文档翻译Capture采集是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的内容，具体关于PhoneGapAPI内容的详解来看本文。

2011-09-13 16:08:58

PhoneGap AP
PhoneGap API帮助文档翻译Notification提醒
PhoneGapAPI帮助文档翻译Notification提醒是本文要介绍的内容，主要是来了解PhoneGapAPI文档的内容，具体PhoneGapAPI文档内容的详解来看本文。

2011-09-13 13:47:56

PhoneGap AP
PhoneGap API帮助文档翻译Geolocation地理位置
PhoneGapAPI帮助文档翻译Geolocation地理位置是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的防疫，来看本文详解。

2011-09-13 16:24:11

PhoneGap AP
PhoneGap API帮助文档翻译Camera摄像头
PhoneGapAPI帮助文档翻译Camera摄像头是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的内容，具体关于PhoneGapAPI文档内容的详解来看本文。

2011-09-13 15:51:11

PhoneGap AP
解析PhoneGap API帮助文档翻译Accelerometer加速度计
PhoneGapAPI帮助文档翻译Accelerometer加速度计是本文要介绍的内容，主要是来了解并学习PhoneGapAPI文档的翻译，具体PhoneGapAPI文档的内容来看本文。

2011-09-13 13:17:27

PhoneGap AP
PhoneGap API介绍：Events
本文将介绍PhoneGapAPI——Events：通过JavaScript截获本地事件。PhoneGap整个生命周期内触发的事件。

2011-12-20 17:15:52

PhoneGap APEvents
PhoneGap开发API教程:events
PhponeGap的开发我也是初接触，自己对要开发的Androidapp需求的功能不是很多，浅读PhoneGapAPI文档，文档比较简单易懂，不过阅读的时候还是将一些文档陆续翻译为中文，方便别人阅读吧，毕竟自己也不喜欢读英文文档。等以后全部翻译完了再把它做成PDF文档提供下载吧。

2011-07-05 17:29:53

PhoneGapevents
PhoneGap官网翻译 开发中常见问题文档
本文翻译自PhoneGap官方网站常见问题解答，PhoneGap官方网站对开发的常见问题进行了充分的解答，如果您英文不好可以参看本文。

2011-10-11 09:50:44

PhoneGap常见问题
PhoneGap官网翻译 iOS开发常见问题文档
本文翻译自PhoneGap官方网站常见问题解答，PhoneGap官方网站对iOS开发的常见问题进行了充分的解答，如果您英文不好可以参看本文。

2011-10-11 09:03:57

常见问题PhoneGap
PhoneGap API介绍：Compass
本文将介绍PhoneGapAPI——Compass：获取设备指向的方向。Compass可以获得该设备的当前朝向。

2011-12-20 11:20:46

PhoneGap APCompass
PhoneGap API介绍：Camera
本文将介绍PhoneGapAPI——Camera:使用设备的摄像头采集照片,对象提供对设备默认摄像头应用程序的访问。

2011-12-19 16:09:32

PhoneGap APCamera
如何设置Eclipse关联JDK文档（暨API帮助文档）
JDK（5.0）的文档已经完全汉化了，可以在sun中国技术社区中获得压缩包htmlzhCN.zip。当然，如果英文水平可以，还是建议多使用英文的文档。遇到实在不容易理解的地方可以用中文帮助作为参考。

2009-07-26 20:36:07

EclipseJDKAPI帮助文档
PhoneGap API介绍：Media
本文将介绍PhoneGapAPI——Media:录制和播放音频文件。PhoneGapAPIMedia对象提供录制和回放设备上的音频文件的能力。

2011-12-22 09:54:40

PhoneGap APMedia
PhoneGap API介绍：Geolocation
本文将介绍PhoneGapAPI&mdash;&mdash;Geolocation:使得你的应用程序可以访问地理位置信息。geolocation对象提供了对设备GPS传感器的访问。Geolocation提供设备的位置信息，例如经度和纬度。位置信息的常见来源包括全球定位系统（GPS），以及通过诸如IP地址、RFID、WiFi和蓝牙的MAC地址、和GSMCDMA手机ID的网络信号所做的推断。不能保证该API返回的是设备的真实位置信...

2011-12-22 09:27:36

PhoneGap APGeolocation
PhoneGap API介绍：Capture
本文将介绍PhoneGapAPI——Capture使用设备的媒体采集应用程序采集媒体文件,提供对设备音频、图像和视频采集功能的访问。

2011-12-19 16:26:39

PhoneGap APCapture
PhoneGap API介绍：Storage
本文将介绍PhoneGapAPI——Storage:截获设备的本地存储选项。Storage提供对设备的存储选项的访问。此API基于W3CWEBSQLDatabaseSpecification和W3CWebStorageAPISpecification。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneGap的实现。对于没有存储支持的设备，PhoneGap的实现应该是完全兼容W3C规范。

2011-12-22 10:45:32

PhoneGap APStorage
点赞
收藏

51CTO技术栈公众号

业务
速览
在线客服