View Source Improve this doc

ons.notification

いくつかの種類のアラートダイアログを作成するためのユーティリティメソッドを収めたオブジェクトです。

使い方 # 

<script>
  ons.notification.alert({
    message: 'Hello, world!'
  });

  ons.notification.confirm({
    message: 'Are you ready?'
    callback: function(answer) {
      // Do something here.
    }
  });

  ons.notification.prompt({
    message: 'How old are you?',
    callback: function(age) {
      ons.notification.alert({
        message: 'You are ' + age + ' years old.'
      });
    });
  });
</script>

実例 #

See the Pen Alert, confirm and prompt dialogs by Onsen & Monaca (@onsen) on CodePen.

Open in New Window

メソッド概要 #

シグネチャ 概要
alert(options) ユーザーへメッセージを見せるためのアラートダイアログを表示します。 表示するメッセージは、テキストかもしくはHTMLを指定できます。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。
confirm(options) ユーザに確認を促すダイアログを表示します。 デオルとのボタンラベルは、"Cancel"と"OK"ですが、これはこのメソッドの引数でカスタマイズできます。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。
prompt(options) ユーザーに入力を促すダイアログを表示します。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。

メソッド

alert(options) #

ユーザーへメッセージを見せるためのアラートダイアログを表示します。 表示するメッセージは、テキストかもしくはHTMLを指定できます。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。

パラメーター
名前 型 概要
options Object オプションを指定するオブジェクトです。
options.message String アラートダイアログに表示する文字列を指定します。
options.messageHTML String アラートダイアログに表示するHTMLを指定します。
options.buttonLabel String 確認ボタンのラベルを指定します。"OK"がデフォルトです。
options.animation String アラートダイアログを表示する際のアニメーション名を指定します。"none", "fade", "slide"のいずれかを指定できます。
options.title String アラートダイアログの上部に表示するタイトルを指定します。"Alert"がデフォルトです。
options.modifier String アラートダイアログのmodifier属性の値を指定します。
options.callback Function アラートダイアログが閉じられた時に呼び出される関数オブジェクトを指定します。

confirm(options) #

ユーザに確認を促すダイアログを表示します。 デオルとのボタンラベルは、"Cancel"と"OK"ですが、これはこのメソッドの引数でカスタマイズできます。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。

パラメーター
名前 型 概要
options Object Parameter object.
options.message String 確認ダイアログに表示するメッセージを指定します。
options.messageHTML String 確認ダイアログに表示するHTMLを指定します。
options.buttonLabels Array ボタンのラベルの配列を指定します。["Cancel", "OK"]がデフォルトです。
options.primaryButtonIndex Number プライマリボタンのインデックスを指定します。デフォルトは 1 です。
options.cancelable Boolean ダイアログがキャンセル可能かどうかを指定します。
options.animation String アニメーション名を指定します。"none", "fade", "slide"のいずれかを指定します。
options.title String ダイアログのタイトルを指定します。"Confirm"がデフォルトです。
options.modifier String ダイアログのmodifier属性の値を指定します。
options.callback Function ダイアログが閉じられた後に呼び出される関数オブジェクトを指定します。 この関数の引数として、押されたボタンのインデックス値が渡されます。 もしダイアログがキャンセルされた場合には-1が渡されます。

prompt(options) #

ユーザーに入力を促すダイアログを表示します。 このメソッドの引数には、options.messageもしくはoptions.messageHTMLのどちらかを必ず指定する必要があります。

パラメーター
名前 型 概要
options Object オプションを指定するオブジェクトです。
options.message String ダイアログに表示するメッセージを指定します。
options.messageHTML String ダイアログに表示するHTMLを指定します。
options.buttonLabel String 確認ボタンのラベルを指定します。"OK"がデフォルトです。
options.primaryButtonIndex Number プライマリボタンのインデックスを指定します。デフォルトは 1 です。
options.cancelable Boolean ダイアログがキャンセル可能かどうかを指定します。デフォルトは false です。
options.animation String アニメーション名を指定します。"none", "fade", "slide"のいずれかを指定します。
options.title String ダイアログのタイトルを指定します。デフォルトは "Alert" です。
options.modifier String ダイアログのmodifier属性の値を指定します。
options.callback Function ダイアログが閉じられた後に実行される関数オブジェクトを指定します。 関数の引数として、インプット要素の中の値が渡されます。ダイアログがキャンセルされた場合には、nullが渡されます。

議論 #