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

= ユーザ選択ウィンドウを表示する =
== 対象バージョン ==
当ドキュメントは'''Rubricks-0.6.x'''向けです。

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

== イメージ ==
[[Image(user_select_window.png,60%)]]

== 使い方 ==
ビューに、'''[wiki:RubricksDevelopmentJointComponentSystemUserSelectWindowJa#render_user_select_window 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',
  })
%>
}}}
必要に応じて、'''[wiki:RubricksDevelopmentJointComponentSystemUserSelectWindowJa#callback コールバック関数]'''を指定します。

{{{
<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) === #render_user_select_window
 * ユーザ選択ウィンドウを描画するヘルパです。

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

オプション：

{{{
#!html
<table class="wiki">
  <tr BGCOLOR="#DCDCDC">
    <td>キー</td>
    <td>必須</td>
    <td>初期値</td>
    <td>型</td>
    <td colspan="5">説明</td>
  </tr>
  <tr>
    <td>:element_id</td>
    <td>○</td>
    <td>-</td>
    <td>String</td>
    <td colspan="5">WindowのDOM-ID。</td>
  </tr>
  <tr>
    <td>:js_options</td>
    <td>-</td>
    <td>-</td>
    <td>Hash</td>
    <td colspan="5">Windowのオプション。<br/>Windowを参照してください。 </td>
  </tr>
  <tr>
    <td>:title</td>
    <td>-</td>
    <td>-</td>
    <td>String</td>
    <td colspan="5">Windowのタイトル</td>
  </tr>
  <tr>
    <td>:variable</td>
    <td>-</td>
    <td>-</td>
    <td>String</td>
    <td colspan="5">Windowを格納するJavaScript変数名</td>
  </tr>
  <tr>
    <td rowspan="8">:options</td>
    <td rowspan="8">-</td>
    <td rowspan="8">-</td>
    <td rowspan="8">Hash</td>
    <td colspan="5">ユーザ選択ウィンドウのオプション。</td>
  </tr>
  <tr BGCOLOR="#DCDCDC">
    <td>キー</td>
    <td>必須</td>
    <td>初期値</td>
    <td>型</td>
    <td>説明</td>
  </tr>
  <tr>
    <td>:default</td>
    <td>-</td>
    <td>nil</td>
    <td>String</td>
    <td>初期表示時に選択済みのユーザをあらわす検索条件。<br>RubricksUser.find(:all)の条件を指定します。</td>
  </tr>
  <tr>
    <td>:limit</td>
    <td>-</td>
    <td>0</td>
    <td>Integer</td>
    <td>選択可能なユーザの最大数。<br>0を指定した場合は無制限となります。</td>
  </tr>
  <tr>
    <td>:prefix</td>
    <td>-</td>
    <td>nil</td>
    <td>String</td>
    <td>HTMLのDOM-IDやJavaScriptの変数名、関数名の接頭辞。<br>必ず、ユニークな文字列を指定してください。</td>
  </tr>
  <tr>
    <td>:str_cancel_button</td>
    <td>-</td>
    <td>'キャンセル'</td>
    <td>String</td>
    <td>キャンセルボタンに表示する文字列。</td>
  </tr>
  <tr>
    <td>:str_selected_title</td>
    <td>-</td>
    <td>'所属ユーザ'</td>
    <td>String</td>
    <td>選択したユーザを表示するセレクトボックスのタイトル。</td>
  </tr>
  <tr>
    <td>:str_submit_button</td>
    <td>-</td>
    <td>'決定'</td>
    <td>String</td>
    <td>実行ボタンに表示する文字列。</td>
  </tr>
</table>
}}}
==== コールバック関数 ==== #callback
||コールバック||意味||
||after_add()||ユーザ追加ボタン押下処理後に実行。||
||after_cancel()||キャンセルボタン押下処理後に実行。||
||after_remove()||ユーザ削除ボタン押下処理後に実行。||
||after_submit(idArray, dataArray)||保存ボタン押下処理後に実行。[[BR]]引数として現在選択されているユーザ情報の配列を受け取ります。||
||before_add()||ユーザ追加ボタン押下処理前に実行。||
||before_cancel()||キャンセルボタン押下処理前に実行。||
||before_remove()||ユーザ削除ボタン押下処理前に実行。||
||before_submit(idArray, dataArray)||保存ボタン押下処理前に実行。[[BR]]引数として現在選択されているユーザ情報の配列を受け取ります。||