文章源自: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被忽略掉