README.md 10 KB

cordova-plugin-dialogs

Build Status

このプラグインは、グローバル 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;
    
  • 両方の alertconfirm は非ブロッキング呼び出し、結果は非同期的にのみ利用できます。

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 ベースので、値は 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

Windows Phone 7 と 8 癖

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

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

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 ベースので、値は 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
  • 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 という名前である必要があります。.