PhoneGap API介绍：Events

时间  2019-11-05
标签 phonegap api 介绍 events 繁體版
原文   原文链接

事件类型：javascript

backbuttoncode

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

document.addEventListener("backbutton", yourCallbackFunction, false);

详述：

  • 若是你须要在Android系统上重载默认后退按钮的行为，能够经过注册一个事件监听器来监听“backbutton”事件。它再也不需求调用任何其余方法来重载后退按钮行为，如今你只须要为“backbutton”事件注册一个事件监听器。

  • 一般状况下，你须要在接收到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。

支持的平台：

  • Android

简单的范例：

document.addEventListener("backbutton", onBackKeyDown, false);      function onBackKeyDown() {    // 处理后退按钮操做 }

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

deviceready

  • 当PhoneGap被彻底加载后会触发该事件。

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

简单的范例：

document.addEventListener("deviceready", onDeviceReady, false);  function onDeviceReady() {     // 如今能够安全使用PhoneGap API }

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

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 }

menubutton

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

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

详述：

  • 若是你须要在Android系统上重载默认菜单按钮的行为，能够经过注册一个事件监听器来监听“menubutton”事件。

  • 一般状况下，你须要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。

支持的平台：

  • Android

简单的范例：

document.addEventListener("menubutton", onMenuKeyDown, false);   function onMenuKeyDown() {     //处理菜单按钮操做 }

完整的范例：

<!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>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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> <body onload="onLoad()"> </body> </html>

pause

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

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

详述：

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

  • 一般状况下，你会但愿一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

  • Android

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

  • iPhone

简单的范例：

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

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

iOS的特异状况：

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

resume

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

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

详述：

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

  • 一般状况下，你会但愿一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

  • Android

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

  • iPhone

简单的范例：

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

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

online

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

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

详述：

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

  • 一般状况下，你会但愿一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

  • Android

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

  • iPhone

简单的范例：

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

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

iOS的特异状况：

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

offline

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

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

详述：

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

  • 一般状况下，你会但愿一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台：

  • Android

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

  • iPhone

简单的范例：

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

完整的范例：

<!DOCTYPE html> <html> <head>     <title>PhoneGap Device Ready Example</title>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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>

iOS的特异状况：

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

Searchbutton

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

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

详述：

  • 若是你须要在Android系统上重载默认搜索按钮的行为，能够经过注册一个事件监听器来监听“searchbutton”事件。

  • 一般状况下，你须要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。

支持的平台：

  • Android

简单的范例：

document.addEventListener("searchbutton", onSearchKeyDown, false);   function onSearchKeyDown() {     // 处理搜索按钮操做 }

完整的范例：

<!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>  <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="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> <body onload="onLoad()"> </body> </html>
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程