intra-mart 標準 タグライブラリ
タグ Select


奨励されていません。select タグに置き換えられました。

フォーム内にコンボボックス(またはリストボックス)を表示します。

属性 list に対しては、Listインターフェースを実装したクラスのインスタンスにMapインターフェースを実装したクラスのインスタンスを 格納して指定して下さい。
属性 list に指定したインスタンスに格納されているすべてのMapインターフェースを実装したクラスのインスタンス の値が、コンボボックス内の表示要素になります。
属性 list に指定されたインスタンスに格納されているMapインターフェースを実装したクラスのoption_value属性で指定された キー名に格納されている値が、コンボボックス内の各要素(<OPTION> タグ)のvalue 値になり、option_text属性で指定されたキー名に格納されている値がコンボボックス内の要素の 画面上での表示名になります。属性 option_valueのデフォルト値は「option_value」、 属性 option_textのデフォルト値は「option_text」です。 (Mapインターフェースを実装したクラスのインスタンスに格納されているキーおよび値が String 以外の場合の動作は保証外。)
属性 selected には、コンボボックスの初期選択(初期表示)値を指定します。 初期選択状態にする値のキー(属性 list に指定したMapインターフェースを実装したクラスのインスタンスの該当する キー名称)と一致する文字列を含むListインターフェースを実装したクラスのインスタンスを指定することで、初期選択状態にする ことができます。
属性 selected に指定した値に該当するキーが属性 list に指定したMapインターフェースを実装したクラスのインスタンス のキー名称として存在しない場合は、どの値も選択状態にはなりません。 (ただし、コンボボックスの初期選択指定が存在しない場合は、ブラウザの仕様で 自動的にコンボボックス内の先頭の要素が初期選択状態として表示されます。) また、初期選択状態とするキーを同時に複数個指定する場合は、属性 selected に 対して複数のキー文字列を含むListインターフェースを実装したクラスのインスタンスを指定する事で可能になります。 その際、配列内の各要素の値として、初期選択状態にするキー(属性 list に格納した Mapインターフェースを実装したクラスのインスタンスのキー名称)を格納してください。
属性 blank は、コンボボックス内の任意の位置に空データを表示させるための 属性指定になります。
値としてキーワード "top" を指定するとボックス内の先頭位置に空データが表示 され、キーワード "bottom" を指定するとボックス内の最後尾位置に空データが 表示されます。
属性 name に指定した値は <SELECT> タグの name 属性に出力されます。
属性 size に指定した値は <SELECT> タグの size 属性に出力されます。
属性 multipleをしてした場合は、 <SELECT> タグに multiple 属性が付加されます。
属性 attr に指定した値は、指定された文字列のまま <SELECT> タグの属性として 出力されます。(<SELECT> タグの仕様に関しては市販のHTMLリファレンスを 参照して下さい)。

サンプル:
<%
Vector list = new Vector();
Hashtable ht1 = new Hashtable();
Hashtable ht2 = new Hashtable();

ht1.put("value","test");
ht1.put("text","テスト");
ht2.put("value","test");
ht2.put("text","テスト");

list.add(ht1);
list.add(ht2);
%>

<FORM>
<imtag:Select list="<%= list%>" option_value="value" option_text="text" name="test1"/>
<imtag:Select list="<%= list%>"
option_value="value" option_text="text"
size="4" name="test2"/>
</FORM>
画面には、コンボボックスとリストボックスが表示されます。
ボックス内には、変数 list に格納されているMapインターフェースを実装したHashtableクラスのインスタンス内のデータが表示されます。

タグ情報
表示名なし
ボディ コンテンツempty

属性一覧
名称必須実行時評価説明
listtruetruejava.util.List 表示リスト
namefalsetruejava.lang.String <SELECT>タグのname属性
sizefalsetruejava.lang.String <SELECT>タグのsize属性
selectedfalsetruejava.util.List 初期選択値の設定
blankfalsetruejava.lang.String キーワードの示す位置へブランクデータを挿入
attrfalsetruejava.lang.String <SELECT>タグ内に指定するその他の属性値
multiplefalsetruejava.lang.String <SELECT>タグのmultiple属性(指定した場合は複数選択可)
option_valuefalsetruejava.lang.String <option>タグのvalue値に対応するキー名
option_textfalsetruejava.lang.String <option>タグのtext値に対応するキー名