通知
可視、 可聽,和觸覺設備通知。
方法
訪問功能
從 3.0 版,科爾多瓦作為外掛程式實現了設備級 Api。 使用 CLI 的 plugin
命令,描述在命令列介面,可以添加或刪除一個專案,為此功能:
$ cordova plugin add org.apache.cordova.dialogs
$ cordova plugin add org.apache.cordova.vibration
$ cordova plugin ls
[ 'org.apache.cordova.dialogs',
'org.apache.cordova.vibration' ]
$ cordova plugin rm org.apache.cordova.dialogs
$ cordova plugin rm org.apache.cordova.vibration
這些命令適用于所有有針對性的平臺,但修改如下所述的特定于平臺的配置設置:
-
Android 系統
(in app/res/xml/config.xml) <feature name="Notification"> <param name="android-package" value="org.apache.cordova.Notification" /> </feature> (in app/AndroidManifest.xml) <uses-permission android:name="android.permission.VIBRATE" />
-
黑莓手機 WebWorks
(in www/plugins.xml) <feature name="Notification"> <param name="blackberry-package" value="org.apache.cordova.notification.Notification" /> </feature> (in www/config.xml) <feature id="blackberry.ui.dialog" />
-
(在 iOS
config.xml
)<feature name="Notification"> <param name="ios-package" value="CDVNotification" /> </feature>
一些平臺可能支援此功能,而無需任何特殊的配置。請參見在概述部分中的平臺支援。
notification.alert
顯示一個自訂的警報或對話方塊框。
navigator.notification.alert(message, alertCallback, [title], [buttonName])
-
消息: 消息對話方塊。(字串)
-
alertCallback: 當警報對話方塊的被解雇時要調用的回檔。(函數)
-
標題: 標題對話方塊。(字串)(可選,預設值為
Alert
) -
buttonName: 按鈕名稱。(字串)(可選,預設值為
OK
)
說明
大多數科爾多瓦實現使用本機對話方塊中的此項功能,但一些平臺使用瀏覽器的 alert
函數,這是通常不那麼可自訂。
支援的平臺
- Android 系統
- 黑莓手機 WebWorks (OS 5.0 和更高)
- iOS
- Tizen
- Windows Phone 7 和 8
- Windows 8
快速的示例
// Android / BlackBerry WebWorks (OS 5.0 and higher) / iOS / Tizen
//
function alertDismissed() {
// do something
}
navigator.notification.alert(
'You are the winner!', // message
alertDismissed, // callback
'Game Over', // title
'Done' // buttonName
);
完整的示例
<!DOCTYPE html>
<html>
<head>
<title>Notification Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API li