diff -r 000000000000 -r e8ccd40d0ef6 Touchgui/plugins/org.apache.cordova.dialogs/doc/zh/index.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Touchgui/plugins/org.apache.cordova.dialogs/doc/zh/index.md Thu Jun 04 14:50:33 2015 +0200 @@ -0,0 +1,247 @@ + + +# 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`. \ No newline at end of file