select

説明

ハッシュテーブルのようなキーと値のペアのテーブルが取得され、ドロップダウンリストボックスに自動的に割り当てられます。また、データベースクエリ結果も取得できます。この場合は value および display 文字列としてクエリから 2 つの列を指定する必要があります。

構文 1

ハッシュテーブルの値を使用してドロップダウンリストボックスに割り当てます。

<jrun:select

  name="name"
  hashtable="hashtable name"
  [multiple=”true|false”]
  [size="1|integer"]
  [required="true|false"]
  [onError="JavaScript function name"]
  [selected="value"]
  [other HTML 4.0 select attributes]>
  optional HTML <option> tags
</jrun:select>

属性

name

必須。java.lang.String を取ります。

ユーザインターフェイスコントロール名。

size

オプション。java.lang.String、java.lang.Integer、または int を取ります。

ドロップダウンリストボックスに表示される行数。既定値は 1 です。文字列を指定した場合は、整数値に解析されます。

hashtable

必須。java.util.Dictionary または java.util.Map のサブクラスを取ります。

キーおよび値のペアのテーブル。

multiple

オプション。java.lang.String、java.lang.Boolean、または boolean を取ります。

この属性を指定した場合は、複数の値を選択できます。既定値は false です。

required

オプション。java.lang.String、java.lang.Boolean、または boolean を取ります。

この属性を指定すると、チェックボックスの選択、ラジオボタンの選択、パスワードの入力、入力フィールドボックスへの文字列の入力が必須になります。既定値は false です。

onError

オプション。java.lang.String を取ります。

JavaScript 関数名。この関数は、クライアント側でフォームの妥当性確認ができない場合に実行されます。

selected

オプション。java.lang.String (複数の場合はカンマ区切りリスト)、 java.lang.String[]、java.util.Enumeration、java.lang.Iterator を取ります。

ドロップダウンリストボックスであらかじめ選択される値で、ハッシュテーブルのキー値です。

その他の HTML 4.0 選択属性

指定したその他の HTML 4.0 選択属性はすべて、生成された select タグの属性に追加されます。

構文 2

データベーステーブルの指定された列を使用してドロップダウンリストに割り当てます。

<jrun:select

  name="name"
  query="database query result"
  [multiple=”true|false”]
  [value="value column"]
  [display="display column"]
  [size="1|integer"]
  [required="true|false"]
  [onError="JavaScript function name"]
  [selected="value"]
  [other HTML 4.0 select attributes]>
  optional HTML <option> tags
</jrun:select>

属性

name

必須。java.lang.String を取ります。

フォームコントロール名。

query

必須。java.sql.ResultSet、javax.sql.RowSet、allaire.taglib.Table、または java.lang.String を取ります。

データベースクエリ結果。この属性は、操作を簡単にする目的で文字列値に対応しています。次を呼び出してクエリオブジェクトを取得します。

pageContext.getAttribute(query);

multiple

オプション。java.lang.String、java.lang.Boolean、または boolean を取ります。

この属性を指定した場合は、複数の値を選択できます。既定値は false です。

value

オプション。java.lang.String を取ります。

キー値。既定値はクエリ結果の最初の列です。

display

オプション。java.lang.String を取ります。

表示値。既定値は value 属性の値です。

size

オプション。java.lang.String、java.lang.Integer、または int を取ります。

ドロップダウンリストボックスに表示される行数。既定値は 1 です。文字列を指定した場合は、整数値に解析されます。

required

オプション。java.lang.String、java.lang.Boolean、または boolean を取ります。

onError

オプション。java.lang.String を取ります。

JavaScript 関数名。この関数は、クライアント側でフォームの妥当性確認ができない場合に実行されます。

selected

オプション。java.lang.String を取ります。

ドロップダウンリストボックスであらかじめ選択される値で、ハッシュテーブルのキー値です。

その他の HTML 4.0 選択属性

指定したその他の HTML 4.0 選択属性はすべて、生成された select タグの属性に追加されます。

例

この JSP は、select タグの使用方法を示しています。

<%@ page import="allaire.taglib.*" %>

<%@ taglib uri="jruntags" prefix="jrun" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>select Tag Example</title></head><body>
<jrun:param id="rs" type="allaire.taglib.QueryTable"/>
<jrun:sql driver="sun.jdbc.odbc.JdbcOdbcDriver"
url="jdbc:odbc:DBNAME" id="q3">
select * from Table1
</jrun:sql>
<jrun:form name="form1" action="select.jsp">
<jrun:select name="box1" required="true" query="<%= rs %>"
value="ID" display="LastName">
</jrun:select> 
<input type="submit" value="validate">
</jrun:form>
</body></html>

JRun タグライブラリリファレンス
JRun タグ