行動裝置上的「提醒」從來不只是畫面上的一塊方塊。PhoneGap 的 Notification 模組把視覺、聽覺與觸覺三種通道整合在同一組 API 之下,讓以 HTML、CSS、JavaScript 撰寫的應用程式,也能跳出接近原生的對話框、發出提示音,甚至驅動震動馬達。
整個模組只對外開放四個方法:
支援平台大致涵蓋 Android、BlackBerry(OS 4.6 以上)、BlackBerry WebWorks(OS 5.0 以上)與 iPhone,但各方法的支援程度略有差異,後文會逐一標註。
跳出一個自訂的警示或對話框。
navigator.notification.alert(message, alertCallback, [title], [buttonName]);
參數說明:
多數平台上的 PhoneGap 會直接呼叫原生的對話框元件,因此外觀與系統其他提示一致;但部分平台只是轉手呼叫瀏覽器本身的 alert(),這種情況下的樣式幾乎無法客製。
支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、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);
function onDeviceReady() {
// PhoneGap 載入完成
}
// 對話框被關閉後呼叫
function alertDismissed() {
// 進行處理
}
// 顯示自訂警示框
function showAlert() {
navigator.notification.alert(
'You are the winner!', // 顯示訊息
alertDismissed, // 關閉後的回呼
'Game Over', // 標題
'Done' // 按鈕文字
);
}
</script>
</head>
<body>
<p><a href="#" onclick="showAlert(); return false;">Show Alert</a></p>
</body>
</html>
顯示一個可高度自訂的確認對話框,讓使用者從多個選項中挑選。
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]);
參數說明:
相比瀏覽器原生的 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">
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
// PhoneGap 載入完成
}
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>
讓裝置發出嗶聲。
navigator.notification.beep(times);
times 為嗶聲重複的次數(Number)。支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、iPhone。
簡短範例:
// 響兩聲 navigator.notification.beep(2);
平台差異值得留意:
beep.wav 的檔案,放在 www/root 目錄下,長度須短於 30 秒。讓裝置震動一段時間。
navigator.notification.vibrate(milliseconds);
參數為震動毫秒數,1000 毫秒等於 1 秒(Number)。支援平台:Android、BlackBerry(OS 4.6)、BlackBerry WebWorks(OS 5.0 以上)、iPhone。
簡短範例:
// 震動 2.5 秒 navigator.notification.vibrate(2500);
iPhone 上的行為不同:時長參數會被忽略,震動長度固定為系統預先設定的值,因此下列寫法效果相同:
navigator.notification.vibrate(); navigator.notification.vibrate(2500); // 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">
document.addEventListener("deviceready", onDeviceReady, false);
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>
實務上提醒一句:震動與音效都應該由使用者的主動操作觸發,例如在點擊事件或遊戲結束的瞬間呼叫,而不是頁面載入時自動播放,否則容易招致使用者反感,也可能被系統靜音或省電機制抑制。