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.alertnavigator.notification.confirmnavigator.notification.promptnavigator.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という名前である必要があります。.