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

摘要: 设备的视觉、听觉和触觉通知。 方法：notification.alertnotification.confirmnotification.beepnotification.vibrate notification.alert 显示一个定制的警告或对话框navigator.notification.alert(message, al ...
 
 
设备的视觉、听觉和触觉通知。
方法：
  • notification.alert
  • notification.confirm
  • notification.beep
  • notification.vibrate


notification.alert


显示一个定制的警告或对话框
  1. 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

简单的范例：
  1. // Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone  
  2. function alertDismissed() {  
  3.     // 进行处理  
  4. }  
  5.   
  6. navigator.notification.alert(  
  7.     'You are the winner!',  // 显示信息  
  8.     alertDismissed,         // 警告被忽视的回调函数  
  9.     'Game Over',            // 标题  
  10.     'Done'                  // 按钮名称  
  11. );  
  12.   
  13. // BlackBerry (OS 4.6) // webOS  
  14. navigator.notification.alert('You are the winner!');
复制代码

完整的范例：
  1. <!DOCTYPE html>  
  2. <html>  
  3. <head>      
  4. <title>Notification Example</title>  
  5.   
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>  
  7. <script type="text/javascript" charset="utf-8">  
  8.   
  9.     // 等待加载PhoneGap  
  10.     document.addEventListener("deviceready", onDeviceReady, false);   
  11.       
  12.     // PhoneGap加载完毕  
  13.     function onDeviceReady() {  
  14.         // 空  
  15.     }  
  16.       
  17.     // 警告对话框被忽视  
  18.     function alertDismissed() {  
  19.         // 进行处理  
  20.     }  
  21.       
  22.     // 显示一个定制的警告框  
  23.     function showAlert() {  
  24.         navigator.notification.alert(  
  25.             'You are the winner!',  // 显示信息  
  26.             alertDismissed,         // 警告被忽视的回调函数  
  27.             'Game Over',            // 标题  
  28.             'Done'                  // 按钮名称  
  29.         );  
  30.     }  
  31.   
  32. </script>  
  33. </head>  
  34. <body>  
  35.     <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>  
  36. </body>  
  37. </html>
复制代码

notification.confirm 
显示一个可定制的确认对话框。
  1. 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

简单的范例：
  1.     // 处理确认对话框返回的结果  
  2.     function onConfirm(button) {  
  3.         alert('You selected button ' + button);  
  4.     }  
  5.       
  6.     // 显示一个定制的确认对话框  
  7.     function showConfirm() {  
  8.         navigator.notification.confirm(  
  9.             'You are the winner!',  // 显示信息  
  10.             onConfirm,              // 按下按钮后触发的回调函数，返回按下按钮的索引  
  11.             'Game Over',            // 标题  
  12.             'Restart,Exit'          // 按钮标签  
  13.         );  
  14.      }  
复制代码

完整的范例：
  1. <!DOCTYPE html>  
  2. <html>  
  3. <head>      
  4. <title>Notification Example</title>  
  5.   
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>  
  7. <script type="text/javascript" charset="utf-8">  
  8.       
  9.     // 等待加载PhoneGap  
  10.     document.addEventListener("deviceready", onDeviceReady, false);   
  11.       
  12.     // PhoneGap加载完毕  
  13.     function onDeviceReady() {  
  14.         // 空  
  15.     }  
  16.       
  17.     // 处理确认对话框返回的结果  
  18.     function onConfirm(button) {  
  19.         alert('You selected button ' + button);  
  20.     }  
  21.       
  22.     // 显示一个定制的确认对话框  
  23.     function showConfirm() {  
  24.         navigator.notification.confirm(  
  25.             'You are the winner!',  // 显示信息  
  26.             onConfirm,              // 按下按钮后触发的回调函数，返回按下按钮的索引     
  27.             'Game Over',            // 标题  
  28.             'Restart,Exit'          // 按钮标签  
  29.         );  
  30.     }  
  31.   
  32. </script>  
  33. </head>  
  34. <body>  
  35.     <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>  
  36. </body>  
  37. </html>
复制代码
notification.beep设备将发出蜂鸣声。
  1. navigator.notification.beep(times);  
复制代码
  • times：蜂鸣声的重复次数。（数字类型）

支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone

简单的范例：
  1.     // 蜂鸣2次！  
  2.     navigator.notification.beep(2);  
复制代码

完整的范例：
  1. <!DOCTYPE html>  
  2. <html>  
  3. <head>      
  4. <title>Notification Example</title>  
  5.   
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>  
  7. <script type="text/javascript" charset="utf-8">  
  8.   
  9. // 等待加载PhoneGap  
  10. document.addEventListener("deviceready", onDeviceReady, false);   
  11.   
  12. // PhoneGap加载完毕  
  13. function onDeviceReady() {  
  14.     // 空  
  15. }  
  16.   
  17. // 显示一个定制的警告框  
  18. function showAlert() {  
  19.     navigator.notification.alert(  
  20.         'You are the winner!',  // 显示信息  
  21.         'Game Over',            // 标题  
  22.         'Done'                  // 按钮名称  
  23.     );  
  24. }  
  25.   
  26. // 蜂鸣三次  
  27. function playBeep() {  
  28.     navigator.notification.beep(3);  
  29. }  
  30.   
  31. // 震动两秒  
  32. function vibrate() {  
  33.     navigator.notification.vibrate(2000);  
  34. }  
  35.   
  36. </script>  
  37. </head>  
  38. <body>  
  39.     <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>  
  40.     <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>  
  41.     <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>  
  42. </body>  
  43. </html>
复制代码

Android的特异情况：
  • Androids会播放在“设置/音效及显示”面板中指定的默认“通知铃声”。

iPhone的特异情况：
  • 忽略蜂鸣次数参数。
  • iPhone没有本地的蜂鸣API。
    • PhoneGap通过多媒体API播放音频文件来实现蜂鸣。
    • 用户必须提供一个包含所需的蜂鸣声的文件。
    • 此文件播放时长必须短于30秒，位于www/root，并且必须命名为beep.wav。
    •  

notification.vibrate 

使设备震动指定的时长。
  1. navigator.notification.vibrate(milliseconds);  
复制代码
  • time：以毫秒为单位的设备震动时长，1000毫秒为1秒。（数字类型）

支持的平台：
  • Android
  • BlackBerry (OS 4.6)
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iPhone

简单的范例：
  1. // 震动2.5秒  
  2. navigator.notification.vibrate(2500);
复制代码
完整的范例：
  1. <!DOCTYPE html>  
  2. <html>  
  3. <head>      
  4. <title>Notification Example</title>  
  5.   
  6. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>  
  7. <script type="text/javascript" charset="utf-8">  
  8.   
  9. // 等待加载PhoneGap  
  10. document.addEventListener("deviceready", onDeviceReady, false);   
  11.   
  12. // PhoneGap加载完毕  
  13. function onDeviceReady() {  
  14.     //空  
  15. }  
  16.   
  17. // 显示定制警告框  
  18. function showAlert() {  
  19.     navigator.notification.alert(  
  20.         'You are the winner!',  // 显示信息  
  21.         'Game Over',            // 标题  
  22.         'Done'                  // 按钮名称  
  23.     );  
  24. }  
  25.   
  26. // 响三次  
  27. function playBeep() {  
  28.     navigator.notification.beep(3);  
  29. }  
  30.   
  31. // 震动两秒  
  32. function vibrate() {  
  33.     navigator.notification.vibrate(2000);  
  34. }  
  35.   
  36. </script>  
  37. </head>  
  38. <body>  
  39.     <p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>  
  40.     <p><a href="#" onclick="playBeep(); return false;">Play Beep</a></p>  
  41.     <p><a href="#" onclick="vibrate(); return false;">Vibrate</a></p>  
  42. </body>  
  43. </html>
复制代码

iPhone的特异情况：
  • time：忽略时长参数，震动时长为预先设定值。
简单的范例：
  1.     <span style="font-size:13px;">navigator.notification.vibrate();  
  2.     navigator.notification.vibrate(2500);   // 2500被忽略掉</span>  
复制代码

本文来自：http://blog.csdn.net/phonegapcn
posted @ 2014-03-20 12:19  huidaoli  阅读(344)  评论(0)  编辑  收藏  举报