|
||
---|---|---|
.. | ||
README.md | ||
index.md |
README.md
cordova-plugin-dialogs
このプラグインは、グローバル navigator.notification
オブジェクトを介していくつかネイティブ ダイアログの UI 要素へのアクセスを提供します。
オブジェクトは、グローバル スコープの ナビゲーター
に添付、それがないまで deviceready
イベントの後。
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.notification);
}
インストール
cordova plugin add cordova-plugin-dialogs
メソッド
navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep
navigator.notification.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
- アンドロイド
- ブラックベリー 10
- Firefox の OS
- iOS
- Tizen
- Windows Phone 7 と 8
- Windows 8
- Windows
Windows Phone 7 と 8 癖
-
組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます
alert()
、グローバル スコープで。window.alert = navigator.notification.alert;
-
両方の
alert
とconfirm
は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。
Firefox OS 互換:
ネイティブ ブロック window.alert()
と非ブロッキング navigator.notification.alert()
があります。
ブラックベリー 10 癖
navigator.notification.alert ('text' コールバック 'title'、'text')
コールバック パラメーターは数 1 に渡されます。
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
- アンドロイド
- ブラックベリー 10
- Firefox の OS
- iOS
- Tizen
- Windows Phone 7 と 8
- Windows 8
- Windows
Windows Phone 7 と 8 癖
-
組み込みブラウザーの機能はありません
window.confirm
が割り当てることによってバインドすることができます。window.confirm = navigator.notification.confirm;
-
呼び出しを
alert
とconfirm
では非ブロッキング、結果は非同期的にのみ使用できます。
Windows の癖
-
Windows8/8.1 の MessageDialog インスタンスを 3 つ以上のボタンを追加することはできません。
-
Windows Phone 8.1 に 2 つ以上のボタンを持つダイアログを表示することはできません。
Firefox OS 互換:
ネイティブ ブロック window.confirm()
と非ブロッキング navigator.notification.confirm()
があります。
navigator.notification.prompt
ブラウザーの プロンプト
機能より詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます。
navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
-
メッセージ: ダイアログ メッセージ。(文字列)
-
promptCallback: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。(機能)
-
title: タイトル (String) (省略可能、既定
プロンプト
ダイアログ) -
buttonLabels: ボタンのラベル (配列) (省略可能、既定値
["OK"、「キャンセル」]
を指定する文字列の配列) -
defaultText: 既定テキスト ボックスの入力値 (
文字列
) (省略可能、既定: 空の文字列)
promptCallback
promptCallback
は、プロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行します。コールバックに渡される results
オブジェクトには、次のプロパティが含まれています。
-
buttonIndex: 押されたボタンのインデックス。*(数)*インデックスがインデックス 1 ベースので、値は
1
、2
、3
などに注意してください。 -
input1: プロンプト ダイアログ ボックスに入力したテキスト。(文字列)
例
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
- アンドロイド
- Firefox の OS
- iOS
- Windows Phone 7 と 8
- Windows 8
- Windows
Android の癖
-
Android は最大 3 つのボタンをサポートしているし、それ以上無視します。
-
アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。
Windows の癖
- Windows プロンプト ダイアログは html ベースのようなネイティブ api の不足のためです。
Firefox OS 互換:
ネイティブ ブロック window.prompt()
と非ブロッキング navigator.notification.prompt()
があります。
navigator.notification.beep
デバイス サウンドをビープ音を再生します。
navigator.notification.beep(times);
- times: ビープ音を繰り返す回数。(数)
例
// Beep twice!
navigator.notification.beep(2);
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- ブラックベリー 10
- iOS
- Tizen
- Windows Phone 7 と 8
- Windows 8
アマゾン火 OS 癖
- アマゾン火 OS デフォルト 設定/表示 & サウンド パネルの下に指定した 通知音 を果たしています。
Android の癖
- アンドロイド デフォルト 通知着信音 設定/サウンド & ディスプレイ パネルの下に指定を果たしています。
Windows Phone 7 と 8 癖
- コルドバ分布からジェネリック ビープ音ファイルに依存します。
Tizen の癖
-
Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。
-
ビープ音ファイル短い、
sounds
アプリケーションのルート ディレクトリのサブディレクトリである必要があり。、beep.wav
という名前である必要があります。.