Struts2标签库

Struts2标签库常用标签

基本概述

对于一个MVC框架而言，重点是实现两部分：业务逻辑控制器部分和视图页面部分。Struts2作为一个优秀的MVC框架，也把重点放在了这两部分上。控制器主要由Action来提供支持，而视图则是由大量的标签来提供支持。

在JavaWeb中，Struts2标签库是一个比较完善，而且功能强大的标签库，它将所有标签都统一到一个标签库中，从而简化了标签的使用，它还提供主题和模板的支持，极大地简化了视图页面代码的编写，同时它还提供对ajax的支持，大大的丰富了视图的表现效果。与JSTL(JSP Standard Library，JSP 标准标签库)相比，Struts2标签库更加易用和强大。

PS：使用标签，需要引入Struts2核心jar包，在jsp头部，加入<%@ taglib uri="/struts-tags" prefix="s" %>

Struts2的模板和主题

Struts2的UI标签都是基于模板和主题的。所谓模板，就是一些代码，Struts2标签使用这些代码渲染生成相应的HTML代码。模板是一个UI标签的外在表现形式，并且每个标签都会有自己对应的模板。如果为所有的UI标签提供样式和视觉效果相似的模板，那么这一系列的模板就形成了一个主题。

Struts2 默认提供了4 种主题，分别为 simple、xhtml、css_xhtml和Ajax。

simple主题：这是最简单的主题，使用该主题时，每个UI标签只生成最基本的HTML元素，没有任何附加功能。
xhtml主题：这是Struts2的默认主题，它对simple主题进行了扩展，提供了布局功能、Label显示名称、以及与验证框架和国际化框架的集成。
css_xhtml：该主题是xhtml的扩展，在对xhtml的基础之上添加对CSS的支持和控制。
Ajax：继承自对xhtml，提供 Ajax支持。

这4种内建主题中，xhtml为默认主题，但xhtml有一定的局限性。因为它使用表格进行布局，并且只支持每一行放一个表单项，这样一来，一旦遇到复杂的页面布局，xhtml就难以胜任了。此时，就需要改变Struts2的默认主题。

通常，通过设置常量struts.ui.theme，来改变默认主题，具体做法是在struts.xml或者struts.properties文件中增加相应的配置。比如想要设置使用simple的主题，那么需要在struts.xml中增加如下配置:

[html]view plain copy
<constant name="struts.ui.theme" value="simple"/>  

或者在struts.properties文件中增加如下配置:

[plain]view plain copy
struts.ui.theme=simple  

Struts2标签库的分类

控制标签

if-elseif-else

[html]view plain copy
<%--1、if elseif else的使用 --%>  
<% //存入请求域中一个学生的成绩  
    request.setAttribute("score", 89);  
%>  
<!-- 判断学生成绩，输出成绩所对应的ABCD -->  
<s:if test="#request.score>90">  
    优秀  
</s:if>  
<s:elseif test="#request.score>80">  
    良好  
</s:elseif>  
<s:else>  
    一般  
</s:else>  

iterator

[html]view plain copy
<s:iterator value="customers">  
<%--s:iterator是struts2的一个迭代标签，它的value属性取值是一个OGNL表达式  
var属性：它的取值就是一个普通的字符串.  
用了var：把每次遍历的对象作为value，把var的值作为key，存入ContextMap中  
没用var：把每次遍历的对象压入栈顶，再下次遍历之前弹栈(从栈顶移走)。  
begin：开始遍历的索引  
end：遍历的结束索引  
step：遍历的步长。   
status：计数器对象  
    count 已经遍历的集合元素个数  
    index 当前遍历元素的索引值  
    odd   是否奇数行  
    even  是否偶数行  
    first 是否第一行  
    last  是否最后一行  
--%>  
     <TR style="FONT-WEIGHT: normal; FONT-STYLE: normal; BACKGROUND-COLOR: white; TEXT-DECORATION: none">  
          <TD><s:property value="custName"/></TD>  
          <TD><s:property value="custLevel"/></TD>  
          <TD><s:property value="custSource"/></TD>  
          <TD><s:property value="custIndustry"/</TD>  
          <TD><s:property value="custAddress"/></TD>  
          <TD><s:property value="custPhone"/></TD>  
     </TR>  
</s:iterator>  

数据标签

property

id：可选属性，指定该元素的标识。
default：可选属性，如果要输出的属性值为null，则显示default属性的指定值。
escape：可选属性，指定是否忽略HTML代码。
value：可选属性，指定需要输出的属性值，如果没有指定该属性，则默认输出ValueStack栈顶的值

[html]view plain copy
<%-- 输出值栈中的值 --%>  
<s:property value="custName"/>  

[html]view plain copy
<%--使用struts2的超链接标签发送请求：  
    <s:a>连接内容</s:a>  
    属性：  
    href：指定url路径  
    action：请求的动作名称（类名）  
    namespace：动作名称所在的名称空间  
    id：指定id  
    method：指定Action调用方法  
 --%>  
 <s:a action="addUIUser" namespace="/user">添加用户</s:a>  
 <s:a action="editUIUser" namespace="/user"> 编辑用户  
     <s:param name="userid" value="%{'1'}"></s:param>  
 </s:a>  
 <a href="${pageContext.request.contextPath}/user/editUIUser.action?userid=1">原始超链接标签-编辑用户</a>  

debug

debug标签用于调试Struts2，使用它会在页面中生成一个debug标签，点击后会显示服务器各种对象信息，包括值栈、ContextMap等。

[html]view plain copy
<s:debug/>  

date

[html]view plain copy
<%--s:date标签的使用：  
    它是用于格式化输出日期  
    name属性：取值是一个ognl表达式，表示要格式化的日期对象  
    format属性：指定格式  
    var属性：取值是一个普通的字符串。  
           把格式化好的日期字符串作为value，把var的取值作为key。存入contextMap中  
--%>  
<% request.setAttribute("myDate",new Date());  
  /*  SimpleDateFormat format = new SimpleDateFormat("yyyy年MM月dd日");  
   String date = format.format(new Date());  
   out.println(date); */  
%>  
${requestScope.myDate}<br/>  
<s:property value="#request.myDate"/>  
<s:date name="#request.myDate" format="yyyy年MM月dd日" var="sdate"/>  
<br>  
格式化后的日期：<s:property value="#sdate"/>  
<br/>  
${sdate}  

url

[html]view plain copy
<%-- url标签  
    作用：用于存放一个路径  
    属性：  
        action：动作名称  
        namespace：名称空间  
        var：取值是一个普通字符串。他会把action和namespace组成一个url作为value，把var的取值作为一个key，存入contextMap中  
--%>  
<s:url action="addUIUser" namespace="/user" var="myurl"/>  
<a href="<s:property value='#myurl'/>">添加用户——url</a>  

表单标签

表单标签的通用属性

属性名	主题	数据类型	说明
title	simple	String	设置表单元素的title属性
disabled	simple	String	设置表单元素是否可用
label	xhtml	String	设置表单元素的label属性
labelPosition	xhtml	String	设置label元素的显示位置，可选值 : top 和 left(默认)
name	simple	String	设置表单元素的name属性，与Action中的属性名对应
value	simple	String	设置表单元素的值
cssClass	simple	String	设置表单元素的class
cssStyle	simple	String	设置表单元素的style属性
required	xhtml	Boolean	设置表单元素为必填项
requiredpositon	xhtml	String	设置必填标记(默认为*)相对于label元素的位置，可选值：left 和right(默认)
tabindex	simple	String	设置表单元素的tabindex属性

<form>标签的常用属性及描述

属性名	是否必填	类型	说明
action	否	String	指定提交时对应的action，不需要action后缀
enctype	否	String	HTML表单enctype属性
method	否	String	HTML表单method属性
namespace	否	String	所提交action的命名空间

<s:submit>标签的常用属性

属性名	是否必填	类型	说明
action	否	String	指定提交时对应的action
method	否	String	指定action中调用的方法

<s:password>标签的常用属性说明

属性名	说明
Name	用于指定密码输入框的名称
Size	用于指定密码输入框的显示宽度，以字符数为单位
MaxLength	用于限定密码输入框的最大输入字符串个数
showPassword	是否显示初始值，即使显示也仍为密文显示，用掩码代替

<s:radio>标签的属性及说明

属性名	是否必填	类型	说明
List	是	Cellection、Map、Enmumeration、Iterator，array	用于生成单选框中的集合
listKey	否	String	指定集合对象中的哪个属性作为选项的value
listValue	否	String	指定集合对象中的哪个属性作为选项的内容

<s:checkboxlist>标签的常用属性及说明

属性名	是否必填	类型	说明
name	否	String	指定该元素的name
list	是	Cellection、Map、Enmumeration、Iterator，array	用于生成多选框的集合
listKey	否	String	生成checkbox的value属性
listValue	否	String	生成checkbox后面显示的文字

select标签的常用属性及说明

属性名	是否必填	类型	说明
list	是	Cellection、Map、Enmumeration、Iterator，array	用于生成下拉框的集合
listKey	否	String	生成选项的value属性
listValue	否	Strmg	生成选项的显示文字
headerKey	否	String	在所有的选项前再加额外的一个选项作为其标题的value值
headerValue	否	String	显示在页面中header选项的内容
Multiple	否	Boolean	指定是否多选，默认为 false
emptyOption	否	Boolean	是否在标题和真实的选项之间加一个空选项
size	否	Int	下拉框的高度，即最多可以同时显示多少个选项

Iterator（迭代）

描述：用于遍历集合（java.util.Collection）或枚举值(java.util.iterator)

参数

名称	必需	默认	类型	描述
status	否		String	如果设置此参数，一个IteratorStatus的实例将会压入每一个遍历的堆栈
value	否		Object/String	要遍历的可枚举的(iteratable)数据源，或者将放入的新列表(List)的对想
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

I18n（国际化操作）

描述：

加载资源包到值堆栈。它可以允许text标志访问任何资源包的信息。而不只当前的action相关联的资源包。

名称

必需

默认

类型

描述

name

是

Object/String

资源包的类路径(如com.xxxx.resources.AppMsg)

否

Object/String

用来标识元素的id。在ui和表单中为HTML的id属性

Include

描述：包含一个servlet的输出(servlet或jsp的页面)

名称	必需	默认	类型	描述
value	时		String	要包含的jsp页面或servlet
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

param

描述：属性是可选的，如果提供，会调用Component的方法，addParameter(String,Object),如果不提供，则外层嵌套标签必须实现UnnamedParametric接口。

Value的提供有两种方式，通过value属性或者标签中间的text，不同之处：

<s:param name="name">zhaosoft</s:param>

参数会以String的格式放入statck

<s:param name="name" value="zhaosoft"/>

该值会以java.lang.Object的格式放入statck

名称	必需	默认	类型	描述
name	否		String	参数名
value	时		String	value表达式
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

set

描述：set标签赋予变量一个特定范围内的值。当希望给一个变量赋一个复杂的表达式，每次访问该变量而不是复杂的表达式时用到。其在两种情况下非常有用：复杂的表达式很耗时（性能提升）或者很难理解（代码的可读性提高）

参数：

名称	必需	默认	类型	描述
name	是		String	变量名字
scope	否		String	变量作用域，可以为application,session,request,page,action
value	否		Object/String	将会赋给变量的值
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

Text

描述：支持国际化信息的标签。国际化信息必须放在一个和当前action同名的resource bundle中，如果没有找到相应message,tag body将被当作默认的message，如果没有tag body，message的name会被作为默认message.

名称	必需	默认	类型	描述
name	是		String	资源属性的名字
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

url

描述：该标签用于创建url，可以通过”param”标签提供request参数。

当includeParams的值是all或get，param标签中定义的参数将有优先权，也就是说其会覆盖其他同名参数的值。

UI标志

单行文本框

Textfield标签输出一个HTML单行文本输入控件，等价于HTML代码<input type=”text”>

名称	必需	默认	类型	描述
maxlength	否	无	Integer	文本输入控件可以输入字符的最大长度
readonly	否	false	Boolean	当该属性为true时，不能输入
size	否	无	Integer	指定可视尺寸
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

例子：

<s:form action="register" method="post">

<s:textfield name="username" label="用户名"></s:textfield>

</s:form>

文本框区

Textarea标签输出一个HTML多行文本输入控件，等价于HTML代码：<textarea />

名称	必需	默认	类型	描述
cols	否	无	Integer	列数
rows	否	无	Integer	行数
readonly	否	false	Boolean	当该属性为true时，不能输入
wrap	否	false	Boolean	指定多行文本输入控件是否应该换行
id	否		Object/String	用来标识元素的id。在ui和表单中为HTML的id属性

例子：

<s:textarea name="personal" cols="10" rows="5" label="个人简历"></s:textarea>

下拉列表

s:select 标签输出一个下拉列表框，相当于HTML代码中的<select/>

名称	必需	默认	类型	描述
list	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容
listKey	否	无	String	指定集合对象中的哪个属性作为选项的value
listValue	否	无	String	指定集合对象中的哪个属性作为选项的内容
headerKey	否	无	String	设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值
headerValue	否	无	String	显示在页面中header选项内容
emptyOption	否	false	Boolean	是否在header选项后面添加一个空选项
multiple	否	false	Boolean	是否多选
size	否	无	Integer	显示的选项个数

例子：

[xml]view plain copy
<%@ page contentType="text/html;charset=GBK" %>  
  
<%@ taglib prefix="s" uri="/struts-tags" %>  
  
<h3>使用name和list属性，list属性的值是一个列表</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"/>  
  
</s:form>  
  
<h3>使用name和list属性，list属性的值是一个Map</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="#{1:'高中',2:'大学',3:'硕士',4:'博士'}"/>  
  
</s:form>  
  
<h3>使用headerKey和headerValue属性设置header选项</h3>  
  
<s:form>  
  
   <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"  
  
       headerKey="-1" headerValue="请选择您的学历"/>  
  
</s:form>  
  
<h3>使用emptyOption属性在header选项后添加一个空的选项</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"  
  
       headerKey="-1" headerValue="请选择您的学历"  
  
       emptyOption="true"/>  
  
</s:form>  
  
<h3>使用multiple属性设置多选</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"  
  
       headerKey="-1" headerValue="请选择您的学历"  
  
       emptyOption="true"  
  
       multiple="true"/>  
  
</s:form>  
  
<h3>使用size属性设置下拉框可显示的选项个数</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"  
  
       headerKey="-1" headerValue="请选择您的学历"  
  
       emptyOption="true"  
  
       multiple="true" size="8"/>  
  
</s:form>  
  
<h3>使用listKey和listValue属性，利用Action实例的属性（property）来设置选项的值和选项的内容</h3>  
  
<s:form>  
  
    <s:select label="最高学历" name="education" list="educations"  
  
       listKey="id" listValue="name"/>  
  
</s:form>

doubleselect标签

doubleselect标签输出关联的两个HTML列表框，产生联动效果。

名称	必需	默认	类型	描述
list	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容
listKey	否	无	String	指定集合对象中的哪个属性作为选项的value，该选项只对第一个列表框起作用
listValue	否	无	String	指定集合对象中的哪个属性作为选项的内容，该选项只对第一个列表框起作用
headerKey	否	无	String	设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值
headerValue	否	无	String	显示在页面中header选项内容
emptyOption	否	false	Boolean
multiple	否	false	Boolean	是否多选
size	否	无	Integer	显示的选项个数，该选项只对第一个列表框起作用
doubleId	否	无	String	指定第二个列表框的ID
doubleList	是	无	Cellection Map Enumeration Iterator array	要迭代的集合
doubleListKey	否	无	String	指定集合对象中的哪个属性作为选项的value，该选项只对第二个列表框起作用
doubleListValue	否	无	String	指定集合对象中的哪个属性作为选项的内容，该选项只对第二个列表框起作用
doubleSize	否	无	Integer	选项个数
doubleName	否	无	String	指定第二个列表框的name映射
doubleValue	否	无	Object	第二个列表框的初始选种项

实例：

[xml]view plain copy
<s:form name="test">  
  
<s:doubleselect label="请选择所在省市"  
  
   name="province" list="{'四川省','山东省'}" doubleName="city"  
  
   doubleList="top == '四川省' ? {'成都市', '绵阳市'} : {'济南市', '青岛市'}" />  
  
</s:form>  
  
<s:form action="doubleselectTag">  
  
<s:doubleselect  
  
        label="请选择所在省市"  
  
        name="province"  
  
        list="provinces"  
  
        listKey="id"  
  
        listValue="name"  
  
        doubleList="cities"  
  
        doubleListKey="id"  
  
        doubleListValue="name"  
  
        doubleName="city"  
  
        headerKey="-1"  
  
        headerValue="---------- 请选择 ----------"  
  
        emptyOption="true" />  
  
</s:form>

复选框

名称

必需

默认

类型

描述

fieldValue

是

true

String

指定在复选框选中时，实际提交的值

复选框组，对应Action中的集合

名称	必需	默认	类型	描述
list	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容
listKey	否	无	String	指定集合对象中的哪个属性作为选项的value
listValue	否	无	String	指定集合对象中的哪个属性作为选项的内容

例子：checkboxlistTag.jsp

[xml]view plain copy
<%@ page contentType="text/html;charset=GBK" %>  
  
<%@ taglib prefix="s" uri="/struts-tags" %>  
  
<s:form>  
  
    <s:checkboxlist name="interest" list="{'足球','篮球','排球','游泳'}" label="兴趣爱好"/>  
  
</s:form>  

文件选择组建

file标签输出一个HTML文件选择框。

名称

必需

默认

类型

描述

否

input

String

HTML accept属性，指出接受文件的MIME类型

按钮

Submit标签输出一个按钮，submit标签和form标签使用可以提供异步表单提交功能。Submit标签可以输出以下三种类型的提交按钮：

Input：等价于 HTML代码<input type=”submit”>

Image：等价于 HTML代码 <input type="image">

Button：<button type="submit"></button>

名称	必需	默认	类型	描述
type	否	input	String	要使用的提交按钮的类型，有效值：input button image
src	否	无	String	为image类型的提交按钮设置图片地址。该属性对input和button类型的提交按钮无效
action	否	无	String	指定处理提交请求的action
method	否	无	String	指定处理提交请求的action的方法

实例

实例1.

<s:submit type="image" method="login" src="images/login.jpg"></s:submit>

页面输出：

实例2.<s:submit type="button" action="selectTag" method="login" label="登陆"></s:submit>

页面输出：

Struts2预定义的前缀：

1。method method:login

使用method前缀，来取代action默认的execute()方法的执行。

[xml]view plain copy
<s:form action="user">  
  
   <s:textfield name="user.username" label="用户名"></s:textfield>  
  
   <s:textfield name="user.password" label="密码"></s:textfield>  
  
   <s:submit value="登陆" name="method:login"></s:submit>  
  
   <s:submit value="注册" name="method:register"></s:submit>  
  
</s:form>

注意：1。input类型的按钮，不能用label设置按钮上的文本，只能用value

2、action前缀

使用action前缀，取代form标签指定的action，导向到另一个action进行处理。

[xml]view plain copy
<s:form action="login">  
  
   <s:textfield name="user.username" label="用户名"></s:textfield>  
  
   <s:textfield name="user.password" label="密码"></s:textfield>  
  
   <s:submit value="登陆"></s:submit>  
  
   <s:submit value="注册" name="action:register"></s:submit>  
  
</s:form>

2、redirect前缀

使用redirect前缀请求重定向到其他的url，甚至可以是web英语程序外部的url。

[xml]view plain copy
<s:form action="login">  
  
   <s:textfield name="user.username" label="用户名"></s:textfield>  
  
   <s:textfield name="user.password" label="密码"></s:textfield>  
  
   <s:submit value="登陆"></s:submit>  
  
   <s:submit value="搜索" name="redirect:www.google.com"></s:submit>  
  
</s:form>

2、redirect-action前缀

使用redirect-action前缀请求重定向到其他的action.

[xml]view plain copy
<s:form action="login">  
  
   <s:textfield name="user.username" label="用户名"></s:textfield>  
  
   <s:textfield name="user.password" label="密码"></s:textfield>  
  
   <s:submit value="登陆"></s:submit>  
  
   <s:submit value="搜索" name="redirect-action:register"></s:submit>  
  
</s:form>

reset标签

reset标签输出一个重置按钮

名称	必需	默认	类型	描述
type	否	input	String	要使用的重置按钮的内容，input、button

<s:reset value="重置"></s:reset>

<s:reset type="button" label="重置"></s:reset>

updownselect标签

updownselect标签创建一个带有上下移动的按钮的列表框，可以通过上下移动按钮来调整列表框的选项的位置。

名称	必需	默认	类型	描述
list	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容
listKey	否	无	String	指定集合对象中的哪个属性作为选项的value
listValue	否	无	String	指定集合对象中的哪个属性作为选项的内容
headerKey	否	无	String	设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值
headerValue	否	无	String	显示在页面中header选项内容
emptyOption	否	false	Boolean	是否在header选项后面添加一个空选项
multiple	否	false	Boolean	是否多选
size	否	无	Integer	显示的选项个数
moveUplabel	否		String	设置向上移动按钮上的文本
moveDownLabel	否		String	设置向下移动按钮上的文本
selectAllLabel	否		String	设置向全部选择按钮上的文本
allowMoveUp	否	无	Boolean	设置是否使用向上移动按钮
allowMoveDown	否	无	Boolean	设置是否使用向下移动按钮
allowSelectAll	否	无	Boolean	设置是否使用全部选择按钮

实例：

[xml]view plain copy
<s:form>  
  
<!-- 使用简单集合来生成可上下移动选项的下拉选择框 -->  
  
<s:updownselect name="a" label="请选择您喜欢的图书" labelposition="top"  
  
    moveUpLabel="向上移动"  
  
    list="{'Spring2.0宝典' , '轻量级J2EE企业应用实战' , 'JavaScript: The Definitive Guide'}"/>  
  
<!-- 使用简单Map对象来生成可上下移动选项的下拉选择框  
  
     且使用emptyOption="true"增加一个空选项-->  
  
<s:updownselect name="b" label="请选择您想选择出版日期" labelposition="top"  
  
    moveDownLabel="向下移动"  
  
    list="#{'Spring2.0宝典':'2006年10月' , '轻量级J2EE企业应用实战':'2007月4月' , '基于J2EE的Ajax宝典':'2007年6月'}"  
  
    listKey="key"  
  
    emptyOption="true"  
  
    listValue="value"/>  
  
<s:bean name="com.zhaosoft.ui.formtag.BookService" id="bs"/>  
  
<!-- 使用集合里放多个JavaBean实例来可上下移动选项的生成下拉选择框 -->  
  
<s:updownselect name="c" label="请选择您喜欢的图书的作者" labelposition="top"  
  
    selectAllLabel="全部选择" multiple="true"  
  
    list="#bs.books"  
  
    listKey="author"  
  
    listValue="name"/>  
  
</s:form>

[java]view plain copy
package com.zhaosoft.ui.formtag;  
  
public class BookService  
{  
  
    public Book[] getBooks()  
  
    {  
  
       return new Book[]  
  
       {  
  
           new Book("Spring2.0宝典","zhaosoft"),  
  
           new Book("轻量级J2EE企业应用实战","zhaosoft"),  
  
           new Book("基于J2EE的Ajax宝典","zhaosoft")  
  
       };  
  
    }  
  
}

optiontransferselect标签

optiontransferselect标签创建一个选项转移列表组建，它由两个<select>标签以及它们之间的用于将选项在两个<select>之间相互移动的按钮组成。表单提交时，将提交两个列表框中选中的选项。

名称	必需	默认	类型	描述
list	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容，该选项只对第一个列表框起作用
listKey	否	无	String	指定集合对象中的哪个属性作为选项的value，该选项只对第一个列表框起作用
listValue	否	无	String	指定集合对象中的哪个属性作为选项的内容，该选项只对第一个列表框起作用
headerKey	否	无	String	设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值
headerValue	否	无	String	显示在页面中header选项内容
multiple	否	false	Boolean	是否多选
size	否	无	Integer	显示的选项个数，该选项只对第一个列表框起作用
doubleId	否	无	String	指定第二个列表框的ID
doubleList	是	无	Cellection Map Enumeration Iterator array	要迭代的集合，使用集合中的元素来设置各个选项，如果doubleList的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容，该选项只对第二个列表框起作用
doubleListKey	否	无	String	指定集合对象中的哪个属性作为选项的value，该选项只对第二个列表框起作用
doubleListValue	否	无	String	指定集合对象中的哪个属性作为选项的内容，该选项只对第二个列表框起作用
doubleHeaderKey	否	无	String	设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值
doubleHeaderVale	否	无	String	显示在页面中header选项内容
doubleEmptyOption	否	无	String	是否在第二列表框的header后面添加一个空选项
doubleMultiple	否	true	Boolean	是否多选
doubleSize	否	无	Integer	选项个数
doubleName	否	无	String	指定第二个列表框的name映射
doubleValue	否	无	Object	第二个列表框的初始选种项
leftTitle	否	无	String	左边列表框的标题
rightTitle	否	<-	String	右边列表框的标题
addToLeftLable	否		String
addToRightLable
addAllToLeftLable
addAllToRightLable
leftUpLabel
leftDownLabel
rightUpLabel
rightDownLabel
allowAddToLeft
allowAddToright
allowAddAllToLeft
allowAddAllToRight
allowSelectAll	否	无	Boolean	设置是否使用全部选择按钮
allowUpdownOnLeft
allowUpDownOnRight

例子：

[xml]view plain copy
<s:head/>  
  
<s:form>  
  
    <s:optiontransferselect  
  
    label="最喜爱的图书"  
  
        name="javaBook"  
  
        list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}"  
  
        doubleName="cBook"  
  
        doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}"/>  
  
</s:form>  
  
---------------------------  
  
<s:form>  
  
    <s:optiontransferselect  
  
    label="最喜爱的图书"  
  
        name="book1"  
  
        leftTitle="Java图书"  
  
        rightTitle="C/C++图书"  
  
        list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}"  
  
        headerKey="-1"  
  
        headerValue="--- 请选择 ---"  
  
        emptyOption="true"  
  
        doubleName="book2"  
  
        doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}"  
  
        doubleHeaderKey="-1"  
  
        doubleHeaderValue="--- 请选择 ---"  
  
        doubleEmptyOption="true"  
  
        addToLeftLabel="向左移动"  
  
        addToRightLabel="向右移动"  
  
        addAllToLeftLabel="全部左移"  
  
        addAllToRightLabel="全部右移"  
  
        selectAllLabel="全部选择"  
  
        leftUpLabel="向上移动"  
  
        leftDownLabel="向下移动"  
  
        rightUpLabel="向上移动"  
  
        rightDownLabel="向下移动"/>  
  
</s:form>

相关推荐