notification.confirm

カスタマイズ可能な確認ダイアログボックスを表示します。

navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels])
  • message: ダイアログのメッセージを表します (String)
  • confirmCallback: 押されたボタンのインデックス (1, 2, または3) とともに呼び出されるコールバック関数を表します (Number)
  • title: ダイアログのタイトルを表します (String) (オプション, デフォルト: "Confirm")
  • buttonLabels: ボタンのラベルを設定するためのカンマ区切りの文字列を表します (String) (オプション, デフォルト: "OK,Cancel")

概要

notification.confirm 関数は、ブラウザの confirm 関数よりも広いカスタマイズ性を持ったネイティブダイアログボックスを表示する関数です。

サポートされているプラットフォーム

  • Android
  • BlackBerry WebWorks (OS 5.0 以上)
  • iPhone
  • Windows Phone 7 (Mango)
  • Bada 1.2 & 2.x

使用例

// 確認ダイアログの表示プロセスの開始
function onConfirm(button) {
    alert('選択されたボタン ' + button);
}

// カスタム確認ダイアログを表示
//
function showConfirm() {
    navigator.notification.confirm(
        'あなたの勝ちです！', // メッセージ
        onConfirm, // 選択されたボタン情報とともに呼ばれるコールバック関数
        'ゲームオーバー', // タイトル
        'リスタート,終了' // ボタン
    );
}

詳細な使用例

<!DOCTYPE html>
<html>
  <head>
    <title>Notification の使用例</title>

    <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Cordova の読み込み完了まで待機
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova 準備完了
    //
    function onDeviceReady() {
        // 処理なし
    }

    // 確認ダイアログの表示プロセスの開始
    function onConfirm(button) {
        alert('選択されたボタン ' + button);
    }

    // カスタム確認ダイアログを表示
    //
    function showConfirm() {
        navigator.notification.confirm(
            'あなたの勝ちです！', // メッセージ
            onConfirm, // 選択されたボタン情報とともに呼ばれるコールバック関数
            'ゲームオーバー', // タイトル
            'リスタート,終了' // ボタン
        );
    }

    </script>
  </head>
  <body>
    <p><a href="#" onclick="showConfirm(); return false;">確認ダイアログを表示</a></p>
  </body>
</html>

Windows Phone 7 に関する注意点

  • ボタンの名前は無視され、常に 'OK|Cancel' が使用されます。
  • ビルトインのブラウザ確認ダイアログ機能はないため、もし confirm('foo'); とだけ書きたい場合は、 window.confirm = navigator.notification.confirm; と window.confirm に Cordova の notification.confirm をアサインできます。
  • 通知と確認の呼び出しはノンブロッキングで、結果は非同期でのみ取得可能です。

Bada 2.x に関する注意点

  • 確認は、 Javascript の alert を使用します。

Bada 1.2 に関する注意点

  • ボタンの名前は無視され、常に 'OK|Cancel' が使用されます。