PhoneGap API介绍：常用事件介绍

最新推荐文章于 2021-02-08 22:03:50 发布
最新推荐文章于 2021-02-08 22:03:50 发布
阅读量871 收藏
点赞数
分类专栏： PhoneGap
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/PZ0605/article/details/40652351
版权

事件类型：

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.     // 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. } 

menubutton

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

详述：

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

支持的平台：

  • Android

简单的范例：

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

完整的范例：

  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> 

pause

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

详述：

  • 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. } 

完整的范例：

  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> 

iOS的特异情况：

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

resume

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

详述：

  • 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. } 

完整的范例：

  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> 

online

  • 当PhoneGap应用程序在线（连接到因特网）的时候触发此事件。
  1. 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. } 

完整的范例：

  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> 

iOS的特异情况：

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

offline

  • 当PhoneGap应用程序离线（没有连接到因特网）的时候触发此事件。
  1. 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. } 

完整的范例：

  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> 

iOS的特异情况：

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

Searchbutton

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

详述：

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

支持的平台：

  • Android

简单的范例：

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

完整的范例：

  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组件及使用方法
05-24
PhoneGap API的使用方法总结和PhoneGap的使用方法、PhoneGap第三方文件。
phonegap-json:远程访问 - JSON
06-08
PhoneGap JSON 远程访问是开发跨平台移动应用时常用的一种技术，主要涉及到JavaScript的JSON对象和Ajax（异步JavaScript和XML）技术。在本文中，我们将深入探讨PhoneGap环境下的JSON远程数据交互，以及如何利用...
phonegap常用事件
孤云博客
08-25 762
随时随地阅读更多技术实战干货，获取项目源码、学习资料，请关注源代码社区公众号(ydmsq666) 在任何PhoneGap项目中，首先应该侦听deviceready事件。事件触发表示DOM已经加载和PhoneGapAPI已加载，此时可以检测其他事件或者处理其他内容。 其他事件： <!DOC...
PhoneGap事件Events
十年饮冰，难凉热血
05-11 1754
参考官网：http://www.phonegap100.com/doc/cordova_events_events.md.html#Events 分析几个事件： 一、 deviceready  事件  在使用 PhoneGap 开发应用时，deviceready 事件是非常常用的。这一事件在设备的本地 环境和页面完全加载完成之后才触发  注意：此事件一般晚于 jquery  的
PhoneGap API介绍：Connection
Blue .Sky.
06-25 683
本文将介绍PhoneGap API  ——Connection:快速检查WiFi或蜂窝网络的信息。Connection对象提供对设备的蜂窝及WiFi连接信息的访问。通过navigator.network接口访问该对象。 属性： connection.type 常量： connection.UNKNOWN connection.ETHERNET connection.W
学习PhoneGap Api
冬眠FF的博客
05-08 579
SplashScreen 打开APP时,会黑屏一段时间, 解决方案:放置一张加载的图片。 config.xml preference name="SplashScreen" value="splash" /> preference name="SplashScreenDelay" value="3000" /> splash 是图片的文件名,3000代表图片
PhoneGap Accelerometer API：监测设备运动
"PhoneGap中文API提供了手机跨平台开发中常用的功能接口，如加速计API，用于获取设备在三个维度上的运动变化数据。" PhoneGap是一个开源框架，它允许开发者使用HTML、CSS和JavaScript来构建原生移动应用。PhoneGap...
PhoneGap入门经典：跨平台移动开发指南
内容涵盖PhoneGap的安装和配置，以及如何利用其API接口访问设备功能，如摄像头、地理定位、 accelerometer（加速度计）和联系人列表等。此外，书中还会讲解如何使用PhoneGap的构建服务，以便简化应用的多平台打包...
PhoneGap入门指南：打造跨平台移动应用
作者Andrew Lunny在书中详尽地介绍了PhoneGap的基础概念、安装步骤、API使用以及关键组件，如Cordova（PhoneGap的前身）。他还可能涵盖了如何创建第一个PhoneGap项目，如何集成常用功能如网络请求、多媒体处理、推送...
phonegap常用事件总结(必看篇)
09-27
以下是对PhoneGap常用事件的详细说明： 1. **deviceready** 事件： 这是PhoneGap中的关键事件，当PhoneGap库加载完成并准备好与设备交互时触发。在执行任何依赖于PhoneGap API的操作之前，必须等待这个事件。通常...
PhoneGap,API帮助文档.zip
04-06
PhoneGap API 帮助文档,加速度计、相机、捕捉、指南针、设备、通讯录、消息、文件、定位、媒体
phonegap中文文档_PhoneGap中文Api帮助文档
weixin_35361584的博客
02-08 193
The connection object, exposed via navigator.connection, provides information about the device's cellular and wifi connection.Androidapp/res/xml/config.xmlapp/AndroidManifest.xmlBlackBerry WebWorksww...
PhoneGap API介绍：Device
巴黎的妖
10-29 559
属性： device.namedevice.phonegapdevice.platformdevice.uuiddevice.version  变量作用域： 由于device被分配到window对象，隐含说明其作用域为全局范围。 // 下面两句引用了相同的“device”对象 var phoneName = window.device.name; var phoneName =
PhoneGap简介
zythy的专栏
03-21 5195
PhoneGap简介。
PhoneGap API帮助文档翻译—Events（事件）
PhoneGap中国
08-19 5089
“   PhoneGap整个生命周期内触发的事件。 事件类型： backbuttondevicereadymenubuttonpauseresumesearchbuttononlineoffline backbutto
phonegap系列之API（六）online与offline
Focus-Fe
03-08 164
  online       连接到Internet时候触发   document.addEventListener("online",onOnline,false);     offline       当网络连接改变offline的时候触发   document.addEventListener("offline",onOffline,false);    ...
1300张图片训练效果
最新发布
10-31
1300张图片训练效果
springboot116基于java的教学辅助平台.zip
10-31
教学辅助平台的出现，是为了更好地服务于教育工作者和学生，提高教学效果和学习效率。该平台集成了多个功能模块，旨在为用户提供全面、便捷的教学辅助服务。 平台首页作为导航入口，提供了清晰的界面布局和便捷的导航功能，方便用户快速找到所需功能。需要注意的是，“首页”这一选项在导航菜单中出现了多次，可能是设计上的冗余，需要进一步优化。 “个人中心”模块允许用户查看和管理自己的个人信息，包括修改密码等账户安全设置，确保用户信息的准确性和安全性。 在教育教学方面，“学生管理”和“教师管理”模块分别用于管理学生和教师的信息，包括学生档案、教师资料等，方便教育工作者进行学生管理和教学安排。同时，“课程信息管理”、“科目分类管理”和“班级分类管理”模块提供了课程信息的发布、科目和班级的分类管理等功能，有助于教育工作者更好地组织和管理教学内容。 此外，“课程作业管理”模块支持教师布置和批改作业，学生可以查看和提交作业，实现了作业管理的线上化，提高了教学效率。而“交流论坛”模块则为学生和教师提供了一个交流和讨论的平台，有助于促进师生互动和学术交流。 最后，“系统管理”模块为平台管理员提供了系统配置.
yolo算法-火灾探测数据集-3466张图像带标签-火灾fire_detect-oqlpv.zip
10-31
yolo系列算法目标检测数据集，包含标签，可以直接训练模型和验证测试，数据集已经划分好，适用yolov5,yolov8,yolov9,yolov7,yolov10,yolo11算法； 包含两种标签格:yolo格式（txt文件）和voc格式（xml文件），分别保存在两个文件夹中; yolo格式：<class> <x_center> <y_center> <width> <height>， 其中： <class> 是目标的类别索引（从0开始）。 <x_center> 和 <y_center> 是目标框中心点的x和y坐标，这些坐标是相对于图像宽度和高度的比例值，范围在0到1之间。 <width> 和 <height> 是目标框的宽度和高度，也是相对于图像宽度和高度的比例值
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值