PhoneGap API帮助文档翻译—Events（事件）

最新推荐文章于 2024-07-23 16:13:18 发布
最新推荐文章于 2024-07-23 16:13:18 发布
阅读量5k 收藏 3
点赞数
分类专栏： PhoneGap 文章标签： phonegap api events 文档 function javascript
“ PhoneGap整个生命周期内触发的事件。
事件类型：
  • backbutton
  • deviceready
  • menubutton
  • pause
  • resume
  • searchbutton
  • online
  • offline
backbutton 
 
当用户在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 οnlοad="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 οnlοad="onLoad()">
</body>
</html>


更多信息参考：

PhoneGap中国：www.phonegap.cn

中文讨论组：groups.google.com/group/PhoneGapCN

phonegapcn
关注
专栏目录
PhoneGap,API帮助文档.zip
04-06
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
vue的app监听返回键
菜鸟的博客
04-11 3086
document.addEventListener('plusready', function (a) { var first = ''; plus.key.addEventListener('backbutton', function () { //获取地址栏目中的url var urls = location.hash.split('/')[1] ...
Key管理设备按键事件
casey的博客
02-08 2372
Key管理设备按键事件
JS_plus.key.addEventListener监听键盘按键
最新发布
小歪博客
07-23 409
【代码】JS_plus.key.addEventListener监听键盘按键。
html5plus 判断手机物理返回键
小冯的博客
09-05 1586
html5plus 判断物理返回键
解决app手机的返回键退出程序的问题
江咏之
09-21 1998
vue项目打包后利用hbuilder生成app，安装到手机上后会发现有一个bug：点击手机的返回键直接退出整个程序了。 解决方案： 只需在index.html加入以下代码就行了 <script type="text/javascript"> document.addEventListener('plusready', function(a) { //等待plus ready后再调用5+ API： 在这里调用5+ API
PhoneGap中文API帮助文档
07-29
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
PhoneGap,API帮助文档翻译整理7-Events_(消息)
04-28
PhoneGap API 提供了一系列的事件，这些事件可以帮助开发者响应移动设备上的特定操作，从而实现更丰富的用户体验。本文将详细介绍 PhoneGap 中的事件类型及其使用方法。 1. **backbutton**：当用户在 Android 设备...
PhoneGap,API帮助文档翻译整理6-Contacts(通讯录).pdf
09-30
在本文中，我们将围绕PhoneGap框架的API文档进行探讨，特别是在处理移动设备上的通讯录（Contacts）数据时所使用的一系列方法。根据提供的文件信息，我们将会详细解释如何使用PhoneGap API来创建和查找通讯录中的...
uni-app 安卓实现监听 PDA 扫码枪等设备按钮
qq1014156094的博客
06-03 5901
plus.key.addEventListener('keydown', event => { console.log("按键：" + event.keyCode); });
android检测物理按钮事件,native js 如何监听到设备物理按钮事件
weixin_34139050的博客
05-26 499
首先我们使用mui 开发app 程序，其中用到第三方插件和设备插件是按照MUI 官网已经实现，但是设备有一个物理按键，这个物理按键是读卡用(code:280)首先我使用android原生写法可以监听到这个按键的事件，使用MUI 官网给的示例只能监听到常规按键的事件，代码如下android 原生代码如下@Overridepublic boolean onKeyDown(int keyCode, ...
uniapp监听系统音量按键
love_yourself_ok的博客
12-14 752
uniapp监听系统音量按键
uniapp监听扫码枪键盘事件|无输入框式监听
hcy5201314521的博客
12-27 3457
这篇文章，是纯借鉴下面这一篇文章的，感觉下面这一篇文章写的非常好一般的扫码枪通过USB或蓝牙连接手机或电脑，充当的是一个外接设备。当扫码后，扫码枪会自动识别内容，然后向连接的电脑或手机发送keydown或keyup。
5+app处理返回键问题，后退按钮返回上一页
华章酱的博客
01-08 2971
直接上代码，官网的例子是这样的： // H5 plus事件处理 function plusReady(){ // Android处理返回键 plus.key.addEventListener('backbutton',function(){ ('iOS'==plus.os.name)?plus.nativeUI.confirm('确认退出？', function(e){ if(e...
html5plus监听返回backbutton按钮事件并判断程序是否退出
qq506930427的博客
12-10 7112
function plusReady() { // Android处理返回键 window.IsSureQuit = false plus.key.addEventListener('backbutton', function () { /** * 有可后退的历史记录，则后退。 * 否则，关闭当前窗口。 ...
移动端默认返回按键，使用h5+修改默认事件
有问题可关注公众号：前端研究院 后台输入问题回复
03-12 2451
  hbuilder的h5+提供开发webapp的诸多便利，很多手机自带back虚拟按键，如果不修改其默认事件，点一下app就退出了，所以我这里提供一种修改这个按键默认事件事件的代码。　首先你要用hbuilder创建一个移动项目，选择空模板，然后将你项目文件全部粘贴进去，首先在你的首页index.html添加如下代码，12345678910111213&lt;script&gt;    docum...
uniapp监听keydown事件（安卓扫描枪）
SKY_Lake
03-17 5545
背景：项目使用扫描枪，需要监听实体键按下事件
html5 key键值屏蔽,Key · Html5+参考 · 看云
weixin_42512128的博客
06-09 506
# [key]()Key管理设备按键事件### 方法：- [addEventListener](http://www.dcloud.io/docs/api/zh_cn/key.shtml#plus.key.addEventListener): 添加按键事件监听器- [removeEventListener](http://www.dcloud.io/docs/api/zh_cn/key.shtml...
PhoneGap API详解：事件处理全指南
这个API文档专注于事件处理，这对于理解和优化PhoneGap应用的用户体验至关重要。下面将详细解释这些关键事件的作用和用法。 1. **deviceready事件**：这是PhoneGap应用中最核心的事件，它标志着PhoneGap的 native ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值