PhoneGap API幫助文檔翻譯Notification提醒
PhoneGap API幫助文檔翻譯Notification提醒是本文要介紹的內(nèi)容,主要是來(lái)了解PhoneGap API文檔的內(nèi)容,具體PhoneGap API文檔內(nèi)容的詳解來(lái)看本文,設(shè)備的視覺(jué)、聽(tīng)覺(jué)和觸覺(jué)通知。
方法:
- notification.alert
- notification.confirm
- notification.beep
- notification.vibrate
- notification.alert
顯示一個(gè)定制的警告或?qū)υ?huà)框。
- navigator.notification.alert(message, alertCallback, [title], [buttonName]);
- navigator.notification.alert(message, alertCallback, [title], [buttonName]);
message:對(duì)話(huà)框信息。(字符串類(lèi)型)
alertCallback:當(dāng)警告對(duì)話(huà)框被忽略時(shí)調(diào)用的回調(diào)函數(shù)。(函數(shù)類(lèi)型)
title:對(duì)話(huà)框標(biāo)題。(字符串類(lèi)型)(可選項(xiàng),默認(rèn)值為“Alert”)
buttonName:按鈕名稱(chēng)(字符串類(lèi)型)(可選項(xiàng),默認(rèn)值為“OK”)
說(shuō)明:
大多數(shù)PhoneGap使用本地對(duì)話(huà)框?qū)崿F(xiàn)該功能。然而,一些平臺(tái)只是簡(jiǎn)單的使用瀏覽器的alert函數(shù),而這種方法通常是不能定制的。
支持的平臺(tái):
Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
簡(jiǎn)單的范例:
- // Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone
- function alertDismissed() {
- // 進(jìn)行處理
- }
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- alertDismissed, // 警告被忽視的回調(diào)函數(shù)
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- // BlackBerry (OS 4.6) // webOS
- navigator.notification.alert('You are the winner!');
- // Android / BlackBerry WebWorks (OS 5.0 and higher) // iPhone
- function alertDismissed() {
- // 進(jìn)行處理
- }
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- alertDismissed, // 警告被忽視的回調(diào)函數(shù)
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- // BlackBerry (OS 4.6) // webOS
- navigator.notification.alert('You are the winner!');
- 完整的范例:
- view plaincopy to clipboardprint?<!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() {
- // 空
- }
- // 警告對(duì)話(huà)框被忽視
- function alertDismissed() {
- // 進(jìn)行處理
- }
- // 顯示一個(gè)定制的警告框
- function showAlert() {
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- alertDismissed, // 警告被忽視的回調(diào)函數(shù)
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- </script>
- </head>
- <body>
- <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
- </body>
- </html>
- <!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() {
- // 空
- }
- // 警告對(duì)話(huà)框被忽視
- function alertDismissed() {
- // 進(jìn)行處理
- }
- // 顯示一個(gè)定制的警告框
- function showAlert() {
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- alertDismissed, // 警告被忽視的回調(diào)函數(shù)
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- </script>
- </head>
- <body>
- <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
- </body>
- </html>
- notification.confirm
顯示一個(gè)可定制的確認(rèn)對(duì)話(huà)框。
- navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]);
- navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]);
message:對(duì)話(huà)框信息。(字符串類(lèi)型)
confirmCallback:按下按鈕后觸發(fā)的回調(diào)函數(shù),返回按下按鈕的索引(1、2或3)。(函數(shù)類(lèi)型)
title:對(duì)話(huà)框標(biāo)題。(字符串類(lèi)型)(可選項(xiàng),默認(rèn)值為“Confirm”)
buttonLabels:逗號(hào)分隔的按鈕標(biāo)簽字符串。(字符串類(lèi)型)(可選項(xiàng),默認(rèn)值為“OK、Cancel”)
#p#
PhoneGap API說(shuō)明:
notification.confirm函數(shù)顯示一個(gè)定制性比瀏覽器的confirm函數(shù)更好的本地對(duì)話(huà)框。
支持的平臺(tái):
Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
簡(jiǎn)單的范例:
- // 處理確認(rèn)對(duì)話(huà)框返回的結(jié)果
- function onConfirm(button) {
- alert('You selected button ' + button);
- }
- // 顯示一個(gè)定制的確認(rèn)對(duì)話(huà)框
- function showConfirm() {
- navigator.notification.confirm(
- 'You are the winner!', // 顯示信息
- onConfirm, // 按下按鈕后觸發(fā)的回調(diào)函數(shù),返回按下按鈕的索引
- 'Game Over', // 標(biāo)題
- 'Restart,Exit' // 按鈕標(biāo)簽
- );
- }
- // 處理確認(rèn)對(duì)話(huà)框返回的結(jié)果
- function onConfirm(button) {
- alert('You selected button ' + button);
- }
- // 顯示一個(gè)定制的確認(rèn)對(duì)話(huà)框
- function showConfirm() {
- navigator.notification.confirm(
- 'You are the winner!', // 顯示信息
- onConfirm, // 按下按鈕后觸發(fā)的回調(diào)函數(shù),返回按下按鈕的索引
- 'Game Over', // 標(biāo)題
- 'Restart,Exit' // 按鈕標(biāo)簽
- );
- }
完整的范例:
- <!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() {
- // 空
- }
- // 處理確認(rèn)對(duì)話(huà)框返回的結(jié)果
- function onConfirm(button) {
- alert('You selected button ' + button);
- }
- // 顯示一個(gè)定制的確認(rèn)對(duì)話(huà)框
- function showConfirm() {
- navigator.notification.confirm(
- 'You are the winner!', // 顯示信息
- onConfirm, // 按下按鈕后觸發(fā)的回調(diào)函數(shù),返回按下按鈕的索引
- 'Game Over', // 標(biāo)題
- 'Restart,Exit' // 按鈕標(biāo)簽
- );
- }
- </script>
- </head>
- <body>
- <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
- </body>
- </html>
- <!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() {
- // 空
- }
- // 處理確認(rèn)對(duì)話(huà)框返回的結(jié)果
- function onConfirm(button) {
- alert('You selected button ' + button);
- }
- // 顯示一個(gè)定制的確認(rèn)對(duì)話(huà)框
- function showConfirm() {
- navigator.notification.confirm(
- 'You are the winner!', // 顯示信息
- onConfirm, // 按下按鈕后觸發(fā)的回調(diào)函數(shù),返回按下按鈕的索引
- 'Game Over', // 標(biāo)題
- 'Restart,Exit' // 按鈕標(biāo)簽
- );
- }
- </script>
- </head>
- <body>
- <p><a href="#" onclick="showConfirm(); return false;">Show Confirm</a></p>
- </body>
- </html>
- notification.beep
設(shè)備將發(fā)出蜂鳴聲。
- navigator.notification.beep(times);
- navigator.notification.beep(times);
times:蜂鳴聲的重復(fù)次數(shù)。(數(shù)字類(lèi)型)
支持的平臺(tái):
Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
簡(jiǎn)單的范例:
- // 蜂鳴2次!
- navigator.notification.beep(2);
- // 蜂鳴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() {
- // 空
- }
- // 顯示一個(gè)定制的警告框
- function showAlert() {
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- // 蜂鳴三次
- function playBeep() {
- navigator.notification.beep(3);
- }
- // 震動(dòng)兩秒
- 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>
- <!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() {
- // 空
- }
- // 顯示一個(gè)定制的警告框
- function showAlert() {
- navigator.notification.alert(
- 'You are the winner!', // 顯示信息
- 'Game Over', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- // 蜂鳴三次
- function playBeep() {
- navigator.notification.beep(3);
- }
- // 震動(dòng)兩秒
- 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>
#p#
Android的特異情況:
Androids會(huì)播放在“設(shè)置/音效及顯示”面板中指定的默認(rèn)“通知鈴聲”。
iPhone的特異情況:
忽略蜂鳴次數(shù)參數(shù)。
iPhone沒(méi)有本地的蜂鳴API。
PhoneGap通過(guò)多媒體API播放音頻文件來(lái)實(shí)現(xiàn)蜂鳴。
用戶(hù)必須提供一個(gè)包含所需的蜂鳴聲的文件。
此文件播放時(shí)長(zhǎng)必須短于30秒,位于www/root,并且必須命名為beep.wav。
notification.vibrate
使設(shè)備震動(dòng)指定的時(shí)長(zhǎng)。
- navigator.notification.vibrate(milliseconds);
- navigator.notification.vibrate(milliseconds);
time:以毫秒為單位的設(shè)備震動(dòng)時(shí)長(zhǎng),1000毫秒為1秒。(數(shù)字類(lèi)型)
支持的平臺(tái):
Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
簡(jiǎn)單的范例:
- // 震動(dòng)2.5秒
- navigator.notification.vibrate(2500);
- // 震動(dòng)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', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- // 響三次
- function playBeep() {
- navigator.notification.beep(3);
- }
- // 震動(dòng)兩秒
- 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>
- <!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', // 標(biāo)題
- 'Done' // 按鈕名稱(chēng)
- );
- }
- // 響三次
- function playBeep() {
- navigator.notification.beep(3);
- }
- // 震動(dòng)兩秒
- 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:忽略時(shí)長(zhǎng)參數(shù),震動(dòng)時(shí)長(zhǎng)為預(yù)先設(shè)定值。
簡(jiǎn)單的范例:
- <span style="font-size:13px;">navigator.notification.vibrate();
- navigator.notification.vibrate(2500); // 2500被忽略掉</span>
小結(jié):PhoneGap API幫助文檔翻譯Notification提醒的內(nèi)容介紹完了,希望通過(guò):PhoneGap API文檔內(nèi)容的學(xué)習(xí)能對(duì)你有所幫助!