PhoneGap API帮助文档翻译—Notification（提醒） PhoneGap API帮助文档翻译—Notification（提醒）...

于 2012-02-01 23:20:00 发布 · 121 阅读 · 0
文章标签：

#移动开发 #javascript #ViewUI

PhoneGap API帮助文档翻译—Notification（提醒）

“设备的视觉、听觉和触觉通知。
方法：
  • 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：忽略时长参数，震动时长为预先设定值。
简单的范例：
<span style="font-size:13px;">navigator.notification.vibrate(); navigator.notification.vibrate(2500); // 2500被忽略掉</span>


“设备的视觉、听觉和触觉通知。
方法：
  • 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：忽略时长参数，震动时长为预先设定值。
简单的范例：
<span style="font-size:13px;">navigator.notification.vibrate(); navigator.notification.vibrate(2500); // 2500被忽略掉</span>


iteye_1547
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值