PhoneGap学习地址 / PhoneGap API介绍：Events

http://blog.csdn.net/phonegapcn

事件类型：

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 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>

PhoneGap学习地址 / PhoneGap API介绍：Events的更多相关文章

watir学习系列--Watir API介绍
文本框: <INPUT id="email" name="_fmu.u._0.e" value="" /> ...
Spring Boot 2.x 编写 RESTful API (一) RESTful API 介绍 & RestController
用Spring Boot编写RESTful API 学习笔记 RESTful API 介绍 REST 是 Representational State Transfer 的缩写所有的东西都是资源,所 ...
phonegap学习入门
phonegap 开发入门 PhoneGap官方网站上有详细的入门示例教程,这里,我针对使用PhoneGap进行Android移动应用的开发对其官网的Get Started进行一些介绍.补充. Ste ...
python学习笔记（win32print API介绍）
最近博主在研究用python控制打印机这里整理下win32print的API介绍,官网地址http://timgolden.me.uk/pywin32-docs/win32print.html Op ...
Phonegap学习点滴（2） -- 网络状态检测
Phonegap学习点滴(2) -- 网络状态检测 http://blog.csdn.net/x251808026/article/details/16992943 方法一:在MainActivit ...
PhoneGap学习（一）
1. 配置要求 Eclipse 3.4+ 这里提供一个不需要Eclipse的Terminal版本教程 2. 安装 SDK + PhoneGap 下载安装Eclipse Classic 下载安装 And ...
Solr系列三：solr索引详解（Schema介绍、字段定义详解、Schema API 介绍）
一.Schema介绍 1. Schema 是什么? Schema:模式,是集合/内核中字段的定义,让solr知道集合/内核包含哪些字段.字段的数据类型.字段该索引存储. 2. Schema 的定义方式 ...
Elasticsearch 6.x版本全文检索学习之分布式特性介绍
1.Elasticsearch 6.x版本全文检索学习之分布式特性介绍. 1).Elasticsearch支持集群默认,是一个分布式系统,其好处主要有两个. a.增大系统容量,如内存.磁盘.使得es集 ...
React 学习笔记（学习地址汇总）
好的博文地址:http://www.ruanyifeng.com/blog/2015/03/react.html 官网学习地址:http://facebook.github.io/react/docs ...

随机推荐

bzoj5月月赛订正
已完成2/9(要准备中考啊QwQ) T1 考虑对所有数分解质因数,其中因子>sqrt(100000)的因子最多有一个,于是我们可以暴力维护<sqrt(100000)的因子个数的前缀和. 剩 ...
KEIL5.25生成.bin文件步骤
添加.bin文件转换工具 KEIL5的自带.bin文件转化工具在安装目录下:我的安装目录是C盘即,C:\Keil_v5\ARM\ARMCC\bin\fromelf.exe 添加格式为:[C:\Keil ...
【UOJ #351】新年的叶子（树的直径，期望）
题目链接这的确是一道好题,我们不妨依循思路一步步推导,看问题是如何被解决的. 做一些约定,设$m$为树的叶子节点个数,设$len$为该树的直径(经过的点数). 毫无疑问,直径可能有多条,我们需要把所 ...
Problem C Dist 解题报告
Problem C Dist Description 有一个$n$个点带边权的连通无向图,边集用$k$个集合$s_1,s_2,\dots,s_k$和$k$个整数\(w_1,w_2,\d ...
解决小米note5 安装了google play store 打不开的问题
打不开的原因是缺少了google play store 运行的一些后台程序去豌豆荚下载如下谷歌安装器(注:安装器有很多种,我试了如下这种成功) 重启手机,google play store 即可正常 ...
python---补充django中文报错（1），Django2.7使用sys.setdefaultencoding('utf-8')，以及使用reload(sys)原因
SyntaxError at /blog/ news/story Non-ASCII character , but no encoding declared; see http://python.o ...
Kafka 0.8 Consumer设计解析
摘要本文主要介绍了Kafka High Level Consumer,Consumer Group,Consumer Rebalance,Low Level Consumer实现的语义,以及适用场景 ...
如何用javascript获取和设置css3属性
==================获取======================== 我想到的第一个思路 var test = document.getElementById('test'); c ...
阿里云centos7.3安装lamp环境
参考文档:http://www.jb51.net/article/96649.htm http://m.blog.csdn.net/qq_33813365/article/details/766337 ...
使用JavaScript缓存图片
在JS中,为了让图片缓存起来,客户端JS定义了一个API,首先利用Image()构造函数来创建一个屏幕外图片对象,之后将该对象的src属性设置期望的URL,由于图片元素并没有添加到文档中,因此它是不 ...

PhoneGap学习地址 / PhoneGap API介绍：Events

PhoneGap学习地址 / PhoneGap API介绍：Events的更多相关文章

随机推荐

热门专题