org.apache.cordova.dialogs

這個外掛程式提供了對一些本機對話方塊的使用者介面元素的訪問。

安裝

cordova plugin add org.apache.cordova.dialogs

方法

navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep

navigator.notification.alert

顯示一個自訂的警報或對話方塊框。大多數科爾多瓦實現使用本機對話方塊中的此項功能，但一些平臺使用瀏覽器的 alert 函數，這是通常不那麼可自訂。

navigator.notification.alert(message, alertCallback, [title], [buttonName])

消息：消息對話方塊。（字串）
alertCallback：當警報對話方塊的被解雇時要調用的回檔。（函數）
標題：標題對話方塊。（字串）（可選，預設值為Alert)
buttonName：按鈕名稱。（字串）（可選，預設值為OK)

示例

function alertDismissed() {
    // do something
}

navigator.notification.alert(
    'You are the winner!',  // message
    alertDismissed,         // callback
    'Game Over',            // title
    'Done'                  // buttonName
);

支援的平臺

亞馬遜火 OS
Android 系統
黑莓 10
火狐瀏覽器作業系統
iOS
Tizen
Windows Phone 7 和 8
Windows 8

Windows Phone 7 和 8 怪癖

有沒有內置瀏覽器警報，但你可以綁定一個，如下所示調用 alert() 在全球範圍內：
```
window.alert = navigator.notification.alert;
```
兩個 alert 和 confirm 的非阻塞的調用，其中的結果才是可用的非同步。

火狐瀏覽器作業系統怪癖：

這兩個本機阻止 window.alert() 和非阻塞 navigator.notification.alert() 可用。

navigator.notification.confirm

顯示一個可自訂的確認對話方塊。

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

消息：消息對話方塊。（字串）
confirmCallback: 要用索引（1、 2 或 3）按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。（函數）
標題：標題對話方塊。（字串）（可選，預設值為Confirm)
buttonLabels：指定按鈕標籤的字串陣列。（陣列）（可選，預設值為 [ OK,Cancel ])

confirmCallback

confirmCallback當使用者按下確認對話方塊中的按鈕之一的時候執行。

回檔將參數 buttonIndex （編號），它是按下的按鈕的索引。請注意索引使用基於 1 的索引，所以值是 1 ， 2 ， 3 ，等等。

示例

function onConfirm(buttonIndex) {
    alert('You selected button ' + buttonIndex);
}

navigator.notification.confirm(
    'You are the winner!', // message
     onConfirm,            // callback to invoke with index of button pressed
    'Game Over',           // title
    ['Restart','Exit']     // buttonLabels
);

支援的平臺

亞馬遜火 OS
Android 系統
黑莓 10
火狐瀏覽器作業系統
iOS
Tizen
Windows Phone 7 和 8
Windows 8

Windows Phone 7 和 8 怪癖

有沒有內置的瀏覽器功能的 window.confirm ，但你可以將它綁定通過分配：
```
window.confirm = navigator.notification.confirm;
```
調用到 alert 和 confirm 的非阻塞，所以結果就是只可用以非同步方式。

火狐瀏覽器作業系統怪癖：

這兩個本機阻止 window.confirm() 和非阻塞 navigator.notification.confirm() 可用。

navigator.notification.prompt

顯示本機的對話方塊，更可自訂的瀏覽器比 prompt 函數。

navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

消息：消息對話方塊。（字串）
promptCallback: 要用索引（1、 2 或 3）按下的按鈕，或者在沒有按下按鈕 (0) 駁回了對話方塊中時調用的回檔。（函數）
標題：對話方塊的標題*（字串）* （可選，預設值為Prompt)
buttonLabels：陣列，這些字串指定按鈕標籤*（陣列）* （可選，預設值為["OK","Cancel"])
defaultText: 預設文字方塊中輸入值（ String ）（可選，預設值: 空字串）

promptCallback

promptCallback當使用者按下一個提示對話方塊中的按鈕時執行。results物件傳遞給回檔的包含以下屬性：

buttonIndex：按下的按鈕的索引。*（人數）*請注意索引使用基於 1 的索引，所以值是 1 ， 2 ， 3 ，等等。
輸入 1：在提示對話方塊中輸入的文本。（字串）

示例

function onPrompt(results) {
    alert("You selected button number " + results.buttonIndex + " and entered " + results.input1);
}

navigator.notification.prompt(
    'Please enter your name',  // message
    onPrompt,                  // callback to invoke
    'Registration',            // title
    ['Ok','Exit'],             // buttonLabels
    'Jane Doe'                 // defaultText
);

支援的平臺

亞馬遜火 OS
Android 系統
火狐瀏覽器作業系統
iOS
Windows Phone 7 和 8

Android 的怪癖

Android 支援最多的三個按鈕，並忽略任何更多。
關於 Android 3.0 及更高版本，使用全息主題的設備按相反的順序顯示按鈕。

火狐瀏覽器作業系統怪癖：

這兩個本機阻止 window.prompt() 和非阻塞 navigator.notification.prompt() 可用。

navigator.notification.beep

該設備播放提示音聲音。

navigator.notification.beep(times);

時間：的次數重複發出蜂鳴音。（人數）

示例

// Beep twice!
navigator.notification.beep(2);

支援的平臺

亞馬遜火 OS
Android 系統
黑莓 10
iOS
Tizen
Windows Phone 7 和 8
Windows 8

亞馬遜火 OS 怪癖

亞馬遜火 OS 播放預設設置/顯示 & 聲音面板下指定的通知聲音。

Android 的怪癖

Android 系統播放的預設通知鈴聲****設置/聲音和顯示面板下指定。

Windows Phone 7 和 8 怪癖

依賴泛型蜂鳴音檔從科爾多瓦分佈。

Tizen 怪癖

Tizen 通過播放音訊檔通過媒體 API 實現會發出蜂鳴聲。
蜂鳴音檔必須很短，必須設在 sounds 子目錄中的應用程式的根目錄中，並且必須命名beep.wav.