Tag reference sheet

Tag library reference for the following tag libraries:

Cubby functions

Cubby functions

This is version 1.0.

    Required attributes are marked with a *

    Cubby tags

    Cubby tag library

    This is version 1.0.

    • form HTML の form タグを出力します。 input/select/textarea タグで参照するフォームオブジェクトを指定します。
    • input HTML の input タグを出力します。
    • select HTML の select タグと option タグを出力します。
    • textarea HTML の textarea タグを出力します。
    • token 2重サブミット防止用の input タグ(type="hidden")を出力します。

    Required attributes are marked with a *

    <t:form>

    HTML の form タグを出力します。 input/select/textarea タグで参照するフォームオブジェクトを指定します。

    Can contain: JSP

    Example

    (JSP)
    <t:form value="${action}">
      ...
    </t:form>
    
    (実行結果)
    <form>
      ...
    </form>
        

    Attributes

    Name Description Type
    value* フォームオブジェクトを指定します。 String

    <t:input>

    HTML の input タグを出力します。

    Can contain: scriptless

    Example

    (JSP)
    <t:input name="title"/>
    
    (実行結果)
    <input name="title" value="Todo Title"/>
        

    Attributes

    Name Description Type
    checkedValue type 属性が radio/checkbox の場合に、フォームオブジェクトの値よりも優先的に比較対象となる値を指定します。 この値と value 属性の値が一致した場合には checked 属性が true になります。 String
    index name 属性で指定したフォームオブジェクトのプロパティに複数の値がある場合に、何番目の要素なのかを指定します。 String
    name* value 属性として出力する値を取得するフォームオブジェクトのプロパティ名を指定します。 この属性の値は name 属性としてそのまま出力されます。 String
    type* この属性の値は type 属性としてそのまま出力されます。 String
    value この属性の値は value 属性としてそのまま出力されます。 指定しなかった場合は name 属性で指定したフォームオブジェクトのプロパティから取得した値が value 属性として出力されます。 type 属性が radio/checkbox の場合は、この値と name 属性で指定したフォームオブジェクトのプロパティから取得した値(もしくは checkedValue で指定した値)が一致した場合には checked 属性が true になりますので、必ず指定するようにしてください。 String

    <t:select>

    HTML の select タグと option タグを出力します。

    Can contain: scriptless

    Example

    (JSP)
    <t:select name="typeId" items="${todoTypes}" labelProperty="name" valueProperty="id"/>
    
    (実行結果)
    <select name="typeId">
      <option name="1">TodoType 1</option>
      <option name="2">TodoType 2</option>
    </select>
        

    Attributes

    Name Description Type
    emptyOption 空白の option タグを出力するかどうかを指定します。 省略した場合は true と見なして先頭に空白の option タグが出力されます。 String
    emptyOptionLabel 空白の option タグの表示文字列を指定します。 省略した場合は何も表示されません。 String
    items* option タグの内容を表すリストを指定します。 配列や java.util.Collection、java.util.Map 型が指定できます。 String
    labelProperty items 属性で指定したリストの要素から、option タグの表示文字列として使用するプロパティ名を指定します。 items 属性で指定した型が java.util.Map の場合は無視されます。 String
    name* selected 属性を付加する option タグを決めるための値を取得するプロパティ名を指定します。 この属性の値は name 属性としてそのまま出力されます。 String
    valueProperty items 属性で指定したリストの要素から、option タグの値として使用するプロパティ名を指定します。 items 属性で指定した型が java.util.Map の場合は無視されます。 String

    <t:textarea>

    HTML の textarea タグを出力します。

    Can contain: scriptless

    Example

    (JSP)
    <t:textarea name="memo"/>
    
    (実行結果)
    <textarea name="memo">Memo 1</textarea>
        

    Attributes

    Name Description Type
    index name 属性で指定したフォームオブジェクトのプロパティに複数の値がある場合に、何番目の要素なのかを指定します。 String
    name* value 属性として出力する値を取得するフォームオブジェクトのプロパティ名を指定します。 この属性の値は name 属性としてそのまま出力されます。 String
    value この属性の値は value 属性としてそのまま出力されます。 指定しなかった場合は name 属性で指定したフォームオブジェクトのプロパティから取得した値が value 属性として出力されます。 String

    <t:token>

    2重サブミット防止用の input タグ(type="hidden")を出力します。

    Can contain: scriptless

    Example

    (JSP)
    <t:form value="${action}">
      <t:token / >
    <t:/form>
    
    (実行結果)
    <form>
      <input type="hidden" name="cubby.token" value="ランダムな文字列...">
    </form>
    
    (アクション)
    public class TokenAction extends Action {
      ...
      public ValidationRules validation = new DefaultValidationRules() {
      @Override
        public void initialize() {
          add("cubby.token", new TokenValidator());
        }
      };
      ...
      @Form
      @Validation(errorPage="token.jsp", rules = "validation")
      public ActionResult message() {
        return new Forward("result.jsp");
      }
            
    }
        

    Attributes

    Name Description Type
    name value 属性として出力する値を取得するフォームオブジェクトのプロパティ名を指定します。 この属性の値は name 属性としてそのまま出力されます。 name 属性が省略された場合の初期値は「cubby.token」です。 String