feat.v1.template.form
クラス Form

java.lang.Object
  拡張feat.v1.template.form.Form

public class Form
extends java.lang.Object

フォームを簡単に扱うためのクラス。 フォーム中のOBJECT要素はサポートしない。

作成者:
SUGIMOTO Ken-ichi

コンストラクタの概要
Form(HTMLElement formElement)
           
 
メソッドの概要
 void addOption(java.lang.String name, ListItem option)
          リストコントロールの選択肢を追加する。
 FormControl getControlElement(java.lang.String name)
          フォームのコントロール要素を返す。
 ListItem[] getOptions(java.lang.String name)
          リストコントロールの選択肢を返す。
 java.lang.String getValue(java.lang.String name)
          フォームのコントロールから値を取得する。
 java.lang.String[] getValues(java.lang.String name)
          フォームのコントロールから値を取得する。
 void setLabel(java.lang.String name, java.lang.String label)
          指定のコントロールにラベルを設定する。
 void setLabels(java.lang.String name, java.lang.String[] labels)
          名前を共有するコントロールにラベルを設定する。
 void setOptions(java.lang.String name, ListItem[] options)
          リストコントロールの選択肢を設定する。
 void setValue(HttpServletRequest request)
          リクエストパラメータの値をフォームにセットする。
 void setValue(java.lang.String name, java.lang.String value)
          フォームのコントロールに値をセットする。
 void setValues(java.lang.String name, java.lang.String[] values)
          フォームのコントロールに値をセットする。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Form

public Form(HTMLElement formElement)
メソッドの詳細

getControlElement

public FormControl getControlElement(java.lang.String name)
フォームのコントロール要素を返す。

パラメータ:
name -
戻り値:
nameで指定されたフォームのコントロール。見つからなかったときは空の配列

getValue

public java.lang.String getValue(java.lang.String name)
フォームのコントロールから値を取得する。 要素から取得する値の以下のとおり。
テキスト、ボタン、HIDDEN要素: value属性値
テキストエリア: テキスト要素
チェックボックス: checked属性のついた要素のvalue属性値
ラジオボタン: checked属性のついた要素の属性値
メニュー: selected属性のついたoption要素のvalue属性値、またはテキスト要素

パラメータ:
name -
戻り値:
コントロールが見つからなかったときはnullを返す

getValues

public java.lang.String[] getValues(java.lang.String name)
フォームのコントロールから値を取得する。 フォームの値が1つのときは要素数が1つの配列を返す。

パラメータ:
name -
戻り値:

setValue

public void setValue(HttpServletRequest request)
リクエストパラメータの値をフォームにセットする。

パラメータ:
request -

setValue

public void setValue(java.lang.String name,
                     java.lang.String value)
フォームのコントロールに値をセットする。

パラメータ:
name -
value -

setValues

public void setValues(java.lang.String name,
                      java.lang.String[] values)
フォームのコントロールに値をセットする。

パラメータ:
name -
values -

getOptions

public ListItem[] getOptions(java.lang.String name)
リストコントロールの選択肢を返す。

パラメータ:
name - リストコントロールの名前
戻り値:
リストコントロールの選択肢。リストコントロールがなかったらnull

setOptions

public void setOptions(java.lang.String name,
                       ListItem[] options)
リストコントロールの選択肢を設定する。

パラメータ:
name - リストコントロールの名前
options -

addOption

public void addOption(java.lang.String name,
                      ListItem option)
リストコントロールの選択肢を追加する。

パラメータ:
name - リストコントロールの名前
option -

setLabel

public void setLabel(java.lang.String name,
                     java.lang.String label)
指定のコントロールにラベルを設定する。 指定の名前のコントロールにlabel要素がなかったら何もしない。 ただし、value属性がラベルの役割をするコントロールの場合はlabel要素ではなくコントロールのvalue属性を設定する。 label要素のfor属性で明示的にコントロールを指定していない場合はラベルを設定しない。

パラメータ:
name -
label -

setLabels

public void setLabels(java.lang.String name,
                      java.lang.String[] labels)
名前を共有するコントロールにラベルを設定する。 checkboxとradioのみ。

パラメータ:
name -
labels -