このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。
cordova plugin add org.apache.cordova.dialogs
navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep
カスタムの警告またはダイアログ ボックスが表示されます。 ほとんどコルドバ ネイティブ] ダイアログ ボックスの使用この機能がいくつかのプラットフォームを使用して、ブラウザーの 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 );
組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます alert()
、グローバル スコープで。
window.alert = navigator.notification.alert;
両方の alert
と confirm
は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。
両方のネイティブ ブロック window.alert()
ノン ブロッキングと navigator.notification.alert()
は利用できます。
カスタマイズ可能な確認のダイアログ ボックスが表示されます。
navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
メッセージ: ダイアログ メッセージ。(文字列)
confirmCallback: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。(機能)
タイトル: ダイアログのタイトル。(文字列)(省略可能、既定値はConfirm
)
buttonLabels: ボタンのラベルを指定する文字列の配列。(配列)(省略可能、既定値は [ OK,Cancel
])
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 );
組み込みブラウザーの機能はありません window.confirm
が割り当てることによってバインドすることができます。
window.confirm = navigator.notification.confirm;
呼び出しを alert
と confirm
では非ブロッキング、結果は非同期的にのみ使用できます。
両方のネイティブ ブロック window.confirm()
ノン ブロッキングと navigator.notification.confirm()
は利用できます。
ブラウザーのより詳細にカスタマイズはネイティブのダイアログ ボックスが表示されます prompt
関数。
navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])
メッセージ: ダイアログ メッセージ。(文字列)
promptCallback: インデックス (1、2、または 3) を押されたボタンまたはダイアログ ボックスは、ボタンを押す (0) なしに解雇されたときに呼び出すコールバック。(機能)
タイトル: (文字列) (省略可能、既定値のタイトル] ダイアログPrompt
)
buttonLabels: ボタンを指定する文字列の配列*(配列)* (省略可能、既定値のラベル["OK","Cancel"]
)
これら: 既定テキスト ボックスの入力値 ( String
) (省略可能、既定: 空の文字列)
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 );
Android は最大 3 つのボタンをサポートしているし、それ以上無視します。
アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。
両方のネイティブ ブロック window.prompt()
ノン ブロッキングと navigator.notification.prompt()
は利用できます。
デバイス サウンドをビープ音を再生します。
navigator.notification.beep(times);
// Beep twice! navigator.notification.beep(2);
Tizen は、メディア API 経由でオーディオ ファイルを再生してビープ音を実装します。
ビープ音ファイルする必要があります短いである必要があります、 sounds
、アプリケーションのルート ディレクトリのサブディレクトリと命名する必要がありますbeep.wav
.