org.apache.cordova.dialogs

このプラグインはいくつかのネイティブのダイアログの UI 要素へのアクセスを提供します。

インストール

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
  • アンドロイド
  • ブラックベリー 10
  • Firefox の OS
  • iOS
  • Tizen
  • Windows Phone 7 と 8
  • Windows 8

Windows Phone 7 と 8 癖

  • 組み込みのブラウザー警告がない呼び出しを次のように 1 つをバインドすることができます alert() 、グローバル スコープで。

    window.alert = navigator.notification.alert;
    
  • 両方の alertconfirm は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。

Firefox OS 互換:

両方のネイティブ ブロック 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 ベースのインデックス化、ので、値は 123 、等。

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 Phone 7 と 8 癖

  • 組み込みブラウザーの機能はありません window.confirm が割り当てることによってバインドすることができます。

    window.confirm = navigator.notification.confirm;
    
  • 呼び出しを alertconfirm では非ブロッキング、結果は非同期的にのみ使用できます。

Firefox OS 互換:

両方のネイティブ ブロック 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"])

  • これら: 既定テキスト ボックスの入力値 ( String ) (省略可能、既定: 空の文字列)

promptCallback

promptCallbackプロンプト ダイアログ ボックス内のボタンのいずれかを押したときに実行されます。resultsコールバックに渡されるオブジェクトに、次のプロパティが含まれています。

  • buttonIndex: 押されたボタンのインデックス。*(数)*メモこと、インデックスを使用して 1 ベースのインデックス化、ので、値は 123 、等。

  • 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

Android の癖

  • Android は最大 3 つのボタンをサポートしているし、それ以上無視します。

  • アンドロイド 3.0 と後、ホロのテーマを使用するデバイスを逆の順序でボタンが表示されます。

Firefox OS 互換:

両方のネイティブ ブロック window.prompt() ノン ブロッキングと navigator.notification.prompt() は利用できます。

navigator.notification.beep

デバイス サウンドをビープ音を再生します。

navigator.notification.beep(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.