Top > 開発ガイド > コンポーネント開発逆引きリファレンス > ユーザ選択ウィンドウを表示する

ユーザ選択ウィンドウを表示する

対象バージョン

当ドキュメントはRubricks-0.6.x向けです。

概要

ユーザを選択するためのウィンドウを描画する機能です。選択されたユーザのIDを取得することができます。

イメージ

使い方

ビューに、render_user_select_windowメソッドを記述します。

<%=
  render_user_select_window({
    :element_id => 'sample_user_select_window',
    :options    => {
      :prefix   => 'sample_user_select_',
    },
    :title      => 'ユーザ選択ウィンドウ',
    :variable   => 'rubricks.sample.user_select_window',
  })
%>

必要に応じて、コールバック関数を指定します。

<script type="text/javascript">
  Object.extend(rubricks.system.user.user_select.sample_user_select_.callbacks, {
    before_cancel: function() {
      rubricks.sample.user_select_window.close();
    },
    before_submit: function(idArray, dataArray) {
      rubricks.sample.user_select_window.close();
      alert(idArray.join(','));
      $A(dataArray).each(
        function(data) {
          alert("id:" + data.id + "\nlogin_name:" + data.login_name + "\nname:" + data.name);
      });
    }
  });
</script>

API

render_user_select_window(options)

• ユーザ選択ウィンドウを描画するヘルパです。

引数	必須	初期値	型	説明
options	○	-	Hash	ユーザ選択ウィンドウのオプションです。下記「オプション」を参照してください。

オプション：

キー	必須	初期値	型	説明
:element_id	○	-	String	WindowのDOM-ID。
:js_options	-	-	Hash	Windowのオプション。 Windowを参照してください。
:title	-	-	String	Windowのタイトル
:variable	-	-	String	Windowを格納するJavaScript変数名
:options	-	-	Hash	ユーザ選択ウィンドウのオプション。
				キー	必須	初期値	型	説明
				:default	-	nil	String	初期表示時に選択済みのユーザをあらわす検索条件。 RubricksUser.find(:all)の条件を指定します。
				:limit	-	0	Integer	選択可能なユーザの最大数。 0を指定した場合は無制限となります。
				:prefix	-	nil	String	HTMLのDOM-IDやJavaScriptの変数名、関数名の接頭辞。 必ず、ユニークな文字列を指定してください。
				:str_cancel_button	-	'キャンセル'	String	キャンセルボタンに表示する文字列。
				:str_selected_title	-	'所属ユーザ'	String	選択したユーザを表示するセレクトボックスのタイトル。
				:str_submit_button	-	'決定'	String	実行ボタンに表示する文字列。

コールバック関数

コールバック	意味
after_add()	ユーザ追加ボタン押下処理後に実行。
after_cancel()	キャンセルボタン押下処理後に実行。
after_remove()	ユーザ削除ボタン押下処理後に実行。
after_submit(idArray, dataArray)	保存ボタン押下処理後に実行。 引数として現在選択されているユーザ情報の配列を受け取ります。
before_add()	ユーザ追加ボタン押下処理前に実行。
before_cancel()	キャンセルボタン押下処理前に実行。
before_remove()	ユーザ削除ボタン押下処理前に実行。
before_submit(idArray, dataArray)	保存ボタン押下処理前に実行。 引数として現在選択されているユーザ情報の配列を受け取ります。