ダイアログの制御プラグイン

テスト環境 ( バージョン番号 ) :2.0.1

このプラグインの詳細は、こちらの原文 ( GitHub ) をご確認ください。

このプラグインは、グローバルな navigator.notification オブジェクトを介して、いくつかのネイティブダイアログ UI エレメントへのアクセスを提供します。このオブジェクトは、グローバルスコープ ( navigator ) に属していますが、使用できるのは、deviceready イベントの発火後になります。

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.notification);
}

プラグイン ID

cordova-plugin-dialogs

プラグインの追加方法 ( Monaca 上での処理 )

このプラグインを使用する場合には、Monaca クラウド IDE の [ Cordova プラグインの管理 ] 上で、Notification プラグインを有効にします。

メソッド

navigator.notification.alert
navigator.notification.confirm
navigator.notification.prompt
navigator.notification.beep

navigator.notification.alert

アラートまたはダイアログを、カスタマイズして表示します。多くの場合、Cordova では、ネイティブ側のダイアログを使用していますが、プラットフォームによっては、ブラウザー側の alert 関数を使用しており、カスタマイズが制限されている場合があります。

navigator.notification.alert(message, alertCallback, [title], [buttonName])

message: ダイアログのメッセージ (String)
alertCallback: アラートダイアログを閉じたときに呼ぶコールバック(Function)
title: ダイアログのタイトル ( String 、任意、デフォルトではAlert )
buttonName: ボタンの名前 ( String 、任意、デフォルトでは OK )

例

function alertDismissed() {
    // do something
}

navigator.notification.alert(
    'You are the winner!',  // message
    alertDismissed,         // callback
    'Game Over',            // title
    'Done'                  // buttonName
);

サポート対象のプラットフォーム

Android
iOS

navigator.notification.confirm

確認用ダイアログを表示します ( カスタマイズ可 )。

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])

message: ダイアログのメッセージ (String)
confirmCallback: 押されたボタンのインデックス ( 1、2、3 )に応じて、または、ボタンを押さずにダイアログを閉じたときに ( 0)、呼ばれるコールバック (Function)
title: ダイアログのタイトル ( String 、任意、デフォルトではConfirm )
buttonLabels: ボタンの名前の配列 ( Array 、任意、デフォルトでは[OK,Cancel])

confirmCallback

confirmCallback は、ユーザーが確認ダイアログボックスのいずれかのボタンを押すと実行されます。このコールバックは、引数として、buttonIndex ( 押されたボタンのインデックス、Number ) を取ります。インデックスは、1 から始まり、値は、1、2、3、・・・となります ( 1 オリジンインデックス方式 )。

例

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
);

サポート対象のプラットフォーム

Android
iOS

Android 特有の動作

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

navigator.notification.prompt

ネイティブのダイアログを表示します ( ブラウザー標準の prompt 関数よりも、カスタマイズが容易 )。

navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText])

message: ダイアログのメッセージ (String)
promptCallback: 押されたボタンのインデックス ( 1、2、3 )に応じて、または、ボタンを押さずにダイアログを閉じたときに ( 0)、呼ばれるコールバック (Function)
title: ダイアログのタイトル ( String 、任意、デフォルトではPrompt )
buttonLabels: ボタンの名前の配列 ( Array 、任意、デフォルトでは[OK,Cancel] )
defaultText: テキストボックスのデフォルトの入力値 (String、任意、デフォルトでは空の文字列 )

promptCallback

prompt ダイアログ上に表示されたボタンを押したときに、promptCallback が実行されます。次のプロパティを格納した results オブジェクトが、このコールバックに渡されます。

buttonIndex: 押されるボタンのインデックスです。インデックスには、1オリジンインデックス方式を使用しており、値は、1、2、3、・・・　となります。 (Number)
input1: prompt ダイアログに入力されたテキスト (String)

例

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
iOS

Android 特有の動作

Android では、最大 3個のボタンを使用できます。それ以上のボタンは無視します。
Android 3.0 以上の場合、Holoテーマを使用している端末では、ボタンの表示が逆順になります。

navigator.notification.beep

ビープ ( beep ) 音を鳴らします。

navigator.notification.beep(times);

times: ビープ音のリピート回数 (Number)

例

// Beep twice!
navigator.notification.beep(2);

サポート対象のプラットフォーム

Android
iOS

Android 特有の動作

Android では、デフォルトの 着信音 を鳴らします [ 設定/音と通知 ( または、ディスプレイ ) 画面で設定 ]。