2.1.35. 確認ダイアログ表示イベントアクション¶
確認ダイアログ表示イベントアクション は ページ内イベント定義 で定義したイベントが発生した際に 確認ダイアログを表示させるイベントアクションである。
このアクションが表示したダイアログで 「キャンセル」 を選択した場合は、 イベントのプロパゲーションおよびデフォルトアクションの発生を抑止する。 また、発生元のイベントが change イベントであった場合、 その変更内容をもとの入力内容に戻す。
一方、ダイアログで 「OK 」 を選択した場合は、イベントプロパゲーションを継続し、 他のイベントハンドラでキャンセルされなければ最終的にデフォルトアクションを実行する。
ダイアログはブラウザのネイティブ部品を使用するので、その表示はクライアント環境 およびブラウザに依存し、CSSによる見た目の制御やタイトル文字列の変更等はできない。
2.1.35.1. コードサンプル¶
プルダウンで特定の項目を選択した場合に確認のダイアログを表示する例する例
<event:listen event="select.amount change"> <event:confirm message="この商品の注文をキャンセルしますがよろしいですか?" condition=":is-blank"> </event:confirm> </event:listen>
2.1.35.2. 仕様¶
属性値一覧 [◎ 必須属性 ○ 任意属性 × 無効(指定しても効果なし)]
名称 | 内容 | タイプ | サーバ | ローカル | 備考 |
---|---|---|---|---|---|
title | 処理内容の簡単な説明 | 文字列 | × | × | 設計書表示用 |
message | ダイアログに表示する文言 | 文字列 | ◎ | ◎ | |
condition | ダイアログを表示させる条件 を表すセレクタ式 | 文字列 | ○ | ○ | 省略した場合は必ず表示される |
target | condition属性で指定した条件判定の対象となる要素を表すセレクタ式 | 文字列 | ○ | ○ | 省略した場合はイベントが発生した要素 |
stop | ダイアログキャンセル時に イベントのプロパゲーション およびデフォルトアクションを 抑制するかどうか。 | 真偽値 | ○ | ○ | デフォルトは’true’
|
revert | ダイアログキャンセル時に 各入力値の状態をイベント発生前 の状態に戻すかどうか。 | 真偽値 | ○ | ○ | changeイベント発生時のみ 意味をもつ。 デフォルトは’true’ |
2.1.35.3. 内部構造・改修時の留意点¶
部品一覧
パス | 内容 |
---|---|
/WEB-INF/tags/widget/event/confirm.tag | このイベントアクションの実体となるタグファイル |
/WEB-INF/tags/widget/event/dialog.tag | アラートダイアログ表示イベントアクション と 確認ダイアログ表示イベントアクション とで共通の内容を実装するタグファイル。 |
/js/nablarch/ui/event/ShowDialogAction.js | ダイアログ表示機能を実装するJS部品。 |