PGBox
P
G
Box

html checkboxタグ

htmlタグのメニューへ戻る



使用した環境
JDK 6 Update 11
struts 1.3.10

チェックボックス<input type="checkbox">を出力します。


属性必須意味
property対応するフォームのプロパティ名を指定する。実際にはname="xxx"が出力される。
nameネストした<html:form>のフォーム以外のフォームのpropertyと関連付ける場合に、bean名を指定する。
valueパラメータの値を指定する。省略した場合は"on"がパラメータの値となる。
disabledtrueを指定した場合、無効状態となる。disabled="disabled"が出力される。
style同名の属性値が出力される。
styleClassclass="xxx"が出力される。
styleIdid="xxx"が出力される。
errorKeyエラーメッセージを取得するリクエスト/セッションバインド名を指定。
errorStyleこのタグのpropertyに関連するエラーメッセージが存在した場合に出力されるstyle属性の値
errorStyleClassこのタグのpropertyに関連するエラーメッセージが存在した場合に出力されるclass属性の値
errorStyleIdこのタグのpropertyに関連するエラーメッセージが存在した場合に出力されるid属性の値
indexed同名複数の入力フィールドを出力する場合に使用する。<logic:iterate>もしくは<nested:iterate>にネストした上で、この属性値をtrueに設定する。
lang同名の属性値が出力される。
bundleメッセージリソースを取得するリクエスト/セッションバインド名を指定。
alt同名の属性値が出力される。
altKeyaltの値をメッセージリソースから取得する場合に、そのキーを指定する。
title同名の属性値が出力される。
titleKeytitleの値をメッセージリソースから取得する場合に、そのキーを指定する。
accesskey同名の属性値が出力される。
tabindex同名の属性値が出力される。
dir同名の属性値が出力される。
onblur同名の属性値が出力される。
onchange同名の属性値が出力される。
onclick同名の属性値が出力される。
ondblclick同名の属性値が出力される。
onfocus同名の属性値が出力される。
onkeydown同名の属性値が出力される。
onkeypress同名の属性値が出力される。
onkeyup同名の属性値が出力される。
onmousedown同名の属性値が出力される。
onmousemove同名の属性値が出力される。
onmouseout同名の属性値が出力される。
onmouseover同名の属性値が出力される。
onmouseup同名の属性値が出力される。



このサンプルで使用しているstruts-configの定義は以下の通りです。
<form-beans>
    <form-bean name="SampleForm" type="pgbox.form.SampleForm" />
</form-beans>

(中略)

<action path="/sample" name="SampleForm" type="pgbox.action.SampleAction" validate="false" scope="request">
    <forward name="success" path="/WEB-INF/view/sample.jsp" />
</action>


例えば、Formが以下のように定義されており
public class SampleForm extends ActionForm {
    
    /** チェックされた場合にtrue */
    private boolean checked;
    
    ※ 以下、setter, getter
}


以下のように、JSPで記述を行った場合
<html:form action="/sample">
    
    <html:checkbox property="checked" />チェック
    
    <html:submit value="送信" />
    
</html:form>


以下のようなhtmlが出力されます。
<form name="SampleForm" method="post" action="/struts-sample/sample.do">
    
    <input type="checkbox" name="checked" value="on">チェック
    
    <input type="submit" value="送信">
    
</form>


アクションでは、以下のように処理を行う事ができます。
public class SampleAction extends Action {
    
    @Override
    public ActionForward execute(ActionMapping mapping, ActionForm form0, ...
        SampleForm form = (SampleForm) form0;
        
        if (form.isChecked()) {
            // チェックされている場合の処理
        
        } else {
            // チェックされていない場合の処理
        
        }
        
        return mapping.findForward("success");
    }
    
}

上記のサンプルでは、フォームのプロパティにboolean型を使用していますが、strutsではフォームにbooleanを使用した場合
そのプロパティのリクエストパラメータの値が"on"もしくは"true"の場合にtrueがセットされ、それ以外の値だった場合はfalseがセットされるようになっています。





htmlタグのメニューへ戻る