文章源自:http://blog.csdn.net/phonegapcn/article/details/6702923
设备的视觉、听觉和触觉通知。
方法：
- notification.alert
- notification.confirm
- notification.beep
- notification.vibrate
notification.alert
显示一个定制的警告或对话框。
navigator.notification.alert(message, alertCallback, [title], [buttonName]);
- message：对话框信息。（字符串类型）
- alertCallback：当警告对话框被忽略时调用的回调函数。（函数类型）
- title：对话框标题。（字符串类型）（可选项，默认值为“Alert”）
- buttonName：按钮名称（字符串类型）(可选项，默认值为“OK”)
说明：大多数PhoneGap使用本地对话框实现该功能。然而，一些平台只是简单的使用浏览器的alert函数，而这种方法通常是不能定制的。
支持的平台：
- Android
- BlackBerry (OS 4.6)
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone
function alertDismissed() {
// 进行处理
}
navigator.notification.alert(
'You are the winner!', // 显示信息
alertDismissed, // 警告被忽视的回调函数
'Game Over', // 标题
'Done' // 按钮名称
);
// BlackBerry (OS 4.6) // webOS
navigator.notification.alert('You are the winner!');
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Notification Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
// 空
}
// 警告对话框被忽视
function alertDismissed() {
// 进行处理
}
// 显示一个定制的警告框
function showAlert() {
navigator.notification.alert(
'You are the winner!', // 显示信息
alertDismissed, // 警告被忽视的回调函数
'Game Over', // 标题
'Done' // 按钮名称
);
}
</script>
</head>
<body>
<p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
</body>
</html>
notification.confirm
显示一个可定制的确认对话框。
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]);
- message：对话框信息。（字符串类型）
- confirmCallback：按下按钮后触发的回调函数，返回按下按钮的索引（1、2或3）。（函数类型）
- title：对话框标题。（字符串类型）（可选项，默认值为“Confirm”）
- buttonLabels：逗号分隔的按钮标签字符串。(字符串类型)（可选项，默认值为“OK、Cancel”）
说明：
notification.confirm函数显示一个定制性比浏览器的confirm函数更好的本地对话框。
支持的平台：
- Android
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// 处理确认对话框返回的结果
function onConfirm(button) {
alert('You selected button ' + button);
}
// 显示一个定制的确认对话框
function showConfirm() {
navigator.notification.confirm(
'You are the winner!', // 显示信息
onConfirm, // 按下按钮后触发的回调函数，返回按下按钮的索引
'Game Over', // 标题
'Restart,Exit' // 按钮标签
);
}
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Notification Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
// 空
}
// 处理确认对话框返回的结果
function onConfirm(button) {
alert('You selected button ' + button);
}
// 显示一个定制的确认对话框
function showConfirm() {
navigator.notification.confirm(
'You are the winner!', // 显示信息
onConfirm, // 按下按钮后触发的回调函数，返回按下按钮的索引
'Game Over', // 标题
'Restart,Exit' // 按钮标签
);
}
</script>
</head>
<body>
<p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
</body>
</html>
notification.beep
设备将发出蜂鸣声。
navigator.notification.beep(times);
times：蜂鸣声的重复次数。（数字类型）
支持的平台：
- Android
- BlackBerry (OS 4.6)
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// 蜂鸣2次！ navigator.notification.beep(2);
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Notification Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
// 空
}
// 显示一个定制的警告框
function showAlert() {
navigator.notification.alert(
'You are the winner!', // 显示信息
'Game Over', // 标题
'Done' // 按钮名称
);
}
// 蜂鸣三次
function playBeep() {
navigator.notification.beep(3);
}
// 震动两秒
function vibrate() {
navigator.notification.vibrate(2000);
}
</script>
</head>
<body>
<p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
<p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>
<p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>
</body>
</html>
Android的特异情况：
Androids会播放在“设置/音效及显示”面板中指定的默认“通知铃声”。
iPhone的特异情况：
- 忽略蜂鸣次数参数。
-
iPhone没有本地的蜂鸣API。
- PhoneGap通过多媒体API播放音频文件来实现蜂鸣。
- 用户必须提供一个包含所需的蜂鸣声的文件。
- 此文件播放时长必须短于30秒，位于www/root，并且必须命名为beep.wav。
notification.vibrate
使设备震动指定的时长。
navigator.notification.vibrate(milliseconds);
time：以毫秒为单位的设备震动时长，1000毫秒为1秒。（数字类型）
支持的平台：
- Android
- BlackBerry (OS 4.6)
- BlackBerry WebWorks (OS 5.0或更高版本)
- iPhone
简单的范例：
// 震动2.5秒 navigator.notification.vibrate(2500);
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Notification Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
//空
}
// 显示定制警告框
function showAlert() {
navigator.notification.alert(
'You are the winner!', // 显示信息
'Game Over', // 标题
'Done' // 按钮名称
);
}
// 响三次
function playBeep() {
navigator.notification.beep(3);
}
// 震动两秒
function vibrate() {
navigator.notification.vibrate(2000);
}
</script>
</head>
<body>
<p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
<p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>
<p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>
</body>
</html>
iPhone的特异情况：
- time：忽略时长参数，震动时长为预先设定值。
简单的范例：
navigator.notification.vibrate(); navigator.notification.vibrate(2500); // 2500被忽略掉
相关推荐
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
标题：PhoneGap,API帮助文档翻译整理4-Compass(指南针) 描述：本文档将深入探讨PhoneGap中Compass API的功能与应用，包括如何获取设备的指南针方向、监听指南针变化以及如何处理相关事件。 ### 一、Compass API...
### PhoneGap Contacts API详解 #### 一、简介 在移动应用开发中，有时我们需要访问用户的通讯录以便于实现社交功能或其他交互式应用需求。PhoneGap（现称Cordova）为开发者提供了一套丰富的API，使得跨平台应用...
PhoneGap API 提供了一系列的事件，这些事件可以帮助开发者响应移动设备上的特定操作，从而实现更丰富的用户体验。本文将详细介绍 PhoneGap 中的事件类型及其使用方法。 1. **backbutton**：当用户在 Android 设备...
在本篇文档中，我们关注的是 PhoneGap 的 Media API，它提供了对移动设备媒体（如音频）的访问和控制能力。 Media API 提供了对音频文件的操作，包括播放、暂停、停止以及获取当前播放位置等功能。以下是对 Media ...
知识点：PhoneGap设备API及其应用 一、PhoneGap设备API概览 PhoneGap是一个开源框架，允许开发者使用HTML、CSS和JavaScript开发跨平台移动应用程序。设备API是PhoneGap提供的核心功能之一，它允许开发者访问设备的...
最新的Phonegap api 中文翻译版。让你快速入门。
知识点：PhoneGap的Camera API详解 一、PhoneGap与Camera API简介 PhoneGap是一个开源框架，允许开发者使用HTML，CSS和JavaScript开发跨平台移动应用程序。它通过提供一系列API来访问设备的功能，如摄像头、GPS、...
### PhoneGap Capture API详解 #### 一、简介 **PhoneGap**是一款开源框架，允许开发者使用HTML、CSS和JavaScript等Web技术开发跨平台移动应用程序。本文档主要介绍**PhoneGap**中的**Capture API**，该API提供了...
在本文中，我们将围绕PhoneGap框架的API文档进行探讨，特别是在处理移动设备上的通讯录（Contacts）数据时所使用的一系列方法。根据提供的文件信息，我们将会详细解释如何使用PhoneGap API来创建和查找通讯录中的...
在本篇文档中，我们将重点关注与“文件”相关的 API，包括 `File`、`DirectoryEntry`、`FileReader` 等。 **File API** 是一组用于读取、写入和管理设备文件系统层级结构的接口。这些接口遵循 W3C 的《文件系统 API...
// PhoneGap 激活时执行 function onDeviceReady() { // 不使用超时，因为不是必需的 // 如果在设备准备好之前调用了 getCurrentPosition，将会失败 navigator.geolocation.getCurrentPosition(onSuccess, on...
### PhoneGap中的Accelerometer（加速度计）API详解 #### 一、简介 加速度计是一种常见的硬件传感器，被广泛应用于智能手机和平板电脑等移动设备上。它主要用于测量设备在三维空间中的线性加速度，通常包括三个轴...
PhoneGap是一种跨平台的移动应用开发框架，它允许开发者使用HTML、CSS和JavaScript来构建原生的移动应用程序。...理解并熟练使用这些API，结合Android平台的具体实践，能够帮助你构建出功能完善的移动应用。
本手册为PhoneGap API的中文版指南，旨在为开发者提供全面、详细的API使用指导，帮助其利用PhoneGap框架开发跨平台移动应用。PhoneGap是一款基于HTML、CSS和JavaScript的技术栈，允许开发者构建适用于多个移动操作...
在PhoneGap中，事件处理是连接用户交互与应用程序逻辑的关键环节，让我们深入探讨PhoneGap API中的事件处理机制。 1. **事件模型**：PhoneGap遵循W3C的DOM事件模型，包括事件监听器、事件冒泡和事件捕获。事件监听...
总的来说，PhoneGap API中文版对于想要使用Web技术开发跨平台移动应用的开发者来说，是一个重要的学习和参考资源，可以帮助他们更高效地理解和利用PhoneGap的功能。通过深入学习和实践，开发者可以创建出功能丰富的...
在“Phonegap-LocalNotification-master”项目中，可能包含的文件有示例代码、配置文件、插件源码等，它们可以帮助开发者深入理解如何在实际项目中集成和使用这个插件。通过对这些文件的分析和学习，开发者可以掌握...