Struts2标签库整理【完整】

Struts2标签库提供了主题、模板支持，极大地简化了视图页面的编写，而且，struts2的主题、模板都提供了很好的扩展性。实现了更好的代码复用。Struts2允许在页面中使用自定义组件，这完全能满足项目中页面显示复杂，多变的需求。
头声明：<%@ taglib uri ="/struts-tags" prefix ="s" %>
struts2的标签可以分为五大类：
一、逻辑控制标签

（1）条件标签
条件标签主要有3个子标签，用于执行基本的条件流转
[java] view plain copy

<s:if test="#request.username=='admin'">  
   您是admin！  
 </s:if>  
<s:elseif test="#request.username=='manager'">  
   您是manager！  
</s:elseif>  
<s:else>  
   您没有身份！  
</s:else>  

test：条件判定语句，值为boolean类型。
（2）迭代标签
<s:iterator>标签用于遍历集合(java.util.Collection)或者枚举值(java.util.Iterator)类型的对象。
1、遍历普通List、数组
[java] view plain copy
//后台存放数据到list中

List<String > list = newArrayList<String>();  
list.add("aaa");list.add("bbb"); list.add("ccc");  

<!-- 用iterator标签遍历list -- >  
<s:iterator value="list"var="v">  
    <s:property value="v"/><br>  
</s:iterator>  
 或者：  
<s:iteratorvalue="list">  
     <s:property/><br>  
 </s:iterator>  

2、遍历对象List、数组 [java] view plain copy

<s:iterator value="users" id="us">  
   <!--可以这样: <s:property value="#us.name"/>  -->  
    <s:property value="name"/>  
    <s:property value="email"/><br/>  
</s:iterator>   

3、 status属性的应用 [java] view plain copy

<s:iterator value="users" id="us" status="u">  
    序列号: <s:property value="#u.index"/>  
     姓名:  <s:property value="name"/>  
     邮件:  <s:property value="email"/>  

     是否第一条:  <s:property value="#u.first"/>  
     是否最后一条:<s:property value="#u.last"/>  
     是否偶数行:  <s:property value="#u.even"/>  
     是否奇数行:  <s:property value="#u.odd"/>  
     当前行数:    <s:property value="#u.count"/>  
</s:iterator>   

id：指定集合中元素在值栈中的名称。
value：指定迭代的迭代体。
var：指向值栈中的值。
status：该属性在迭代时会产生一个IteratorStatus对象,该对象可以判断当前元素的位<置。
二、数据输出标签

（1）action标签
<s:action>标签用于在jsp页面中直接调用Action
[java] view plain copy

<s:action name="loginAction"  namespace="/user" ignoreContextParam="false"  executeResult="true" >  
    <s:param name="userName" value="'张三'"></s:param>    
</s:action>  

name：struts.xml中指定Action的名称
executeResult：指定是否将Action的处理结果包含到本页面中.默认值为false（即不包含）
ignoreContextParam：指定该页面的请求参数是否需要传入调用的Action中,默认值是false（即传入参数）

注意：
<s:param>是以request方式的值的,而不是以参数传值,所以request.getParameter(“”)会获取不到值,通过request.getAttribute(“”)方式可以获取到。

（2）date标签
<s:date>标签用以格式化日期并显示
[java] view plain copy

<s:date name="user.birth" format="yyyy-MM-dd HH:ss:mm"nice="false"/>   

name：表示要输出的日期对象。
format：输出的日期格式。
nice：指定是否输出指定日期与当前时刻之间的时差。若nice=”true”，则format属性失效，只输出当前时刻与指定日期间的间隔；若nice=“false”，则是输出指定日期。
（3）bean标签 bean标签用于创建javaBean实例，需要java类提供相应的getter、setter方法
[java] view plain copy

<s:bean name="pojo.User" id = "user">  
       <s:param name="name" value=" '张三' "></s:param>  
       <s:param name="email" value=" '48964565@qq.com' "></s:param>  
       <s:param name="age" value="20"/>  
       <s:param name="birth" value="'2010-4-1'"/>  
 </s:bean>  

<s:property value="#user.name"/>  
<s:property value="#user.email"/>  
<s:property value="#user.age"/>  
<s:date name="#user.birth" format="yyyy-MM-dd" nice="false"/>  

name： 必填，指定要实例化的JavaBean的实现类
id： 可选。如指定了该属性，则该Javabean实例会被放入StackContext中(不是ValueStack)，从而允许直接通过该id属性来访问该JavaBean实例。如果未指定，则该Javabean实例会被放入ValueStack中，该标签结束，生成的子集被移出valuestack栈。
注意：java类String类型的属性赋值时，必须再加个单引号’ ‘。
（4）parma标签
param标签用于为其他标签添加参数，用法如下：
[java] view plain copy

<!--  第一种用法 -->  
<s:param name="参数名" value="参数值"/>  
<!-- 第二种用法 -->  
<s:param name="参数名">参数值</s:param>  

注意：字符串赋值时要加单引号。详见bean标签用法。
（5）property标签
property标签用于输出一个属性值。
[java] view plain copy

<s:property value="user.name" escape="false" default="默认值" />  

value：指定属性的名称，默认值是栈顶元素。
escape：指定输出的内容是否要经过HTML转义，默认值是true。escape=”false”表示会将类似h2标签的字符串转义成html显示。
default：指定默认值。
（6）<s:url>标签和<s：a>标签
<s:url>标签通常与<s:a>标签一起使用，<s:url>标签主要用于赋值給href属性，用于指定链接的地址和传递的参数。
[java] view plain copy

<!-- 指定链接的action 及 传递的参数 -->  
<s:url action="getUserList" namespace="test2" id="getUserListUrl" method="execute">    
   <s:param name="id" value="1"></s:param>     
   <s:param name="page" value="1"></s:param>  
</s:url>  

<!-- 链接地址引用了<s:url>的值 -->  
<s:a href="%{getUserListUrl}" >获取用户列表</s:a>  

其结果等同于

<a href="/test2/getUserList ! execute ?id = 1 & page = 1"></a>

（7）<s:debug>标签
<s:debug>标签用于在页面上生成一个连接，当点击链接时,可以看到ValueStack 和 Stack Context中的内容
三、HTML表单标签

（1）表单标签
[java] view plain copy

<s:form action=" " method="post" enctype="multipart/form-data" namespace="/test1">   
      <s:textfield  label="姓名" name="username"  tooltip="Enter your Name here"  />  
      <s:password label="密码"  name="password" />  
      <s:textarea  label="备注" name="remark" cols="20" rows="3" tooltip="Enter your remark"/>  
      <s:hidden name="topic.ic" value="<s:property value='topic.id'/>"></s:hidden>   //注意<s:property>标签的value值是单引号。  
      <s:submit   value="提交"/>  
      <s:reset  value="重置" />  
</s:form>  

enctype：共有3个值：
1）application/x-www-form-urlencoded：默认值，使用范围广，但向服务器发送大量文本、包含非ASCII字符的文本或二进制数据时该编码效率很低。
2）multipart/form-data：上传二进制数据，使用该值即可完整的传递文本文件数据。
3）text/plain：主要使用于发送电子邮件的应用。
namespace：设置action的包命名空间。
注意：当该标签设置了namespace属性后，action属性设置不能加.action后缀。
（2）<s:select>标签
[java] view plain copy

<s:select  label="性别"  name="gender" list="#{1:'男',2:'女'}"  listKey="key" listValue="value" value="#{2:'女'}" emptyOption="true" headerKey="-1"  headerValue="--请选择性别--"  tooltip="Choose your gender" />   

<!-- 数据后台获取 -->  
List<User> user;  //后台添加数据到list中  
<s:select  label="用户"  name="gender" list="user"  listKey="userId" listValue="name"  emptyOption="true" headerKey="-1"  headerValue="--请选择用户--"  tooltip="Choose your gender" />  

list属性(必设)：必须是一个可以迭代的源，如为一个List, Map, Set等
1)如果集合为javabean：

<s:select theme="simple" name="sex" list="#request.sexs" listKey="id" listValue="name"></s:select>

2)如果集合为list：

<s:select theme="simple" name="sexList" list="{'男','女'}"></s:select>

3)如果集合为map：

<s:select theme="simple" name="sexMap" list="#{1:'男',2:'女'}" listKey="key" listValue="value"></s:select>

listKey：设置后台传送的数据项。
listValue：设置前台显示的数据项。
emptyOption：设置是否有空选项。
value：设置默认显示数据列表list中的选项。
headerValue：设置下拉框头条显示数据。
headerKey：设置下拉框头条后台传回的数据。
（3）<s:combobox>标签
[java] view plain copy

<s:combobox theme="simple" label="选择你喜欢的颜色" name="colorNames"  headerValue="------请选择------" headerKey="1"  list="{'红','橙','黄','绿','青','蓝','紫'}" />      
属性说明详见<s:select>标签。

（4）<s:checkboxlist>标签
[java] view plain copy

<s:checkboxlist name="hobby" label="兴趣"  list="#{1:'football', 2:'music',3:'basketball', 4:'computer'}" listKey="key" listValue="value" tooltip="Choose your hobby"/>  

属性说明详见标签
。
（5）<s:checkbox>标签
[java] view plain copy

<s:checkbox name="age" label="年龄" value="18"  fieldValue="yes" tooltip="Confirmed that your are Over 18"/>  

fieldVaule：设置选中时向后台传送的数据（默认不设时返回的是布尔类型）。
value：设置前台显示的数据。
（6）<s:radio>标签
[java] view plain copy

<s:radio list="#{1:'男',2:'女'}" name="gender" label="性别" required="true" value="1"></s:radio>  

value：默认选中的选项的key值。
（7）<s:file>标签
[java] view plain copy

<s:file label="上传" theme="simple" name="uploadfile"/>  

（8）<s:hidden>标签
[java] view plain copy

<s:hidden name="uid"/>  

四、HTML非表单标签

（1）<s:actionerror>标签
actionerror标签用于输出存储在ActionError中的值。

<s:actionerror/>

Action类中添加actionerror信息：addActionError(“出错了!”);
（2）<s:actionmessage>标签
actionmessage标签用于输出存储在ActionMessage中的值。

<s:actionmessage/>

Action类中添加actionmessage信息：addActionMessage(“出错了!”);
（3）<s:fielderror>标签
fielderror标签用于输出FieldError中的值。默认错误信息显示在所对应field标签的上方。

<s:textfield name="user.name" label="姓名" />

Action类中添加fielderror信息：addFieldError(“user.name”, “用户名不能为空!”);
注意:(1) actionerror与actionmessage功能差不多，不过在<head></head>中加上<s:head/>标签后，actionerror和fielderror的错误信息有CSS效果（变红），而actionmessage无效果。
(2) 在添加错误信息前最好先clearErrorsAndMessages();来清空之前加载的错误信息。
五、AJAX标签

<%@taglib prefix="sx" uri="/struts-dojo-tags" %>

记得在中加上标签，标签 用来下载Dojo文件和相应的Javascript代码
（1）<sx:div>标签
<sx:div>标签可以异步定时加载刷新数据。
[java] view plain copy

<!-- 用于显示异步加载的数据 -->  
<div id="msg">     
   <s:property value="message"/>  
</div>  
<!-- 定时5s加载test2.action中的message属性值，并刷新id=“msg”的div标签-->  
<sx:div updateFreq="5000" href="test2/test2.action" delay="100" errorText="出错了!" loadingText="正在请求..." showLoadingText="true" indicator="msg">  
</sx:div>    

href：异步请求的资源地址。
updateFreq：自动更新div内容的间隔，以毫秒为单位。
autoStart：页面加载后是否启动定时器，默认为true。
delay：第一个异步请求开始之前等待的时间，以毫秒为单位。
loadText：当请求正在处理时显示的文本。
showLoadingText：是否显示loadText值，默认为false。
errorText：当请求失败时显示的文本。
indicator：当请求正在处理时具有这个id的元素将被显示。
executeScript：执行服务器返回内容中的javascript代码，默认为false。
formId：指定表单id，表单字段将被序列化并作为参数传递。
（2）<sx:a>标签
[java] view plain copy

<!-- 单击"用户信息列表信息" 链接后会加载userList.jsp表到userListDiv标签上，其中getUserList.action是跳转到userList.jsp页面的 -->  
<sx:a href="test2/getUserList.action"  targets="userListDiv" loadingText="加载中..." showLoadingText="true" errorText="加载失败!">用户信息列表</sx:a>  
<div id="userListDiv"></div>  

<!-- userList.jsp -->  
<body>  
  <table border="1" cellpadding="0" cellspacing="0">  
    <thead>  
        <tr>  
            <th colspan="4">用户信息列表</th>  
        </tr>  
    </thead>  
    <tbody>  
        <tr>  
            <th>序列号</th>  
            <th>用户名</th>  
        </tr>  
        <s:iterator value="users" id="us" status="u">  
        <tr>  
            <td><s:property value="#u.index"/></td>  
            <td><s:property value="name"/></td>  
        </tr>  
        </s:iterator>  
    </tbody>       
</table>  
</body>  

href：异步请求的资源地址。
targets：被更新的元素列表。
loadText：当请求正在处理时显示的文本。
showLoadingText：是否显示loadText值，默认为false。
errorText：当请求失败时显示的文本。
indicator：当请求正在处理时具有这个id的元素将被显示。
executeScript：执行服务器返回内容中的javascript代码，默认为false。
formId：指定表单id，表单字段将被序列化并作为参数传递。
（3）<sx:submit>标签
<sx:submit>标签的使用和标签的使用一样，这里就不举例了。
（4）<sx:datetimepicker>标签
[java] view plain copy

<sx:datetimepicker name="book.publicationDate" value="today" label="出版日期" displayFormat="yyyy-MM-dd" ></sx:datetimepicker> 

（5）<sx:textarea>标签
[java] view plain copy

<sx:textarea name="user.remark"  label="备注"  rows="20" cols="50"></sx:textarea>  

提示：<sx:textarea>标签提交的文本是带Html标签的。
（6）<sx:tree>标签
[java] view plain copy

<sx:tree label="城市" id="city" showRootGrid="false" showGrid="false" treeSelectedTopic="treeSelected">       
      <sx:treenode label="北京" id="bj">       
            <sx:treenode label="朝阳" id="cy"></sx:treenode>       
            <sx:treenode label="中关村" id="zgc"></sx:treenode>       
      </sx:treenode>  
      <sx:treenode label="天津" id="tj">  
           <sx:treenode label="白洋淀" id="byd"></sx:treenode>       
      </sx:treenode>  
</sx:tree>      

<script language="JavaScript" type="text/javascript">  
     dojo.event.topic.subscribe("treeSelected", function treeNodeSelected(node) {  
         alert(node.node.widgetId + node.node.title);  
     });  
</script>  

showRootGrid：是否显示根节点，默认为true。
showGrid：是否显示结点间的连接线，默认为true。
treeSelectedTopic：选中时的时间。
（7）<sx:tabbedpanel>标签
[java] view plain copy

<sx:tabbedpanel id="tab1" cssStyle="width:300px;" labelposition="top" selectedTab="tab2">        
      <sx:div  id="tab1" label="Tab 1" cssStyle="height:100px;" href="index.jsp" closable="true" preload="false" >  
          Local Tab 1       
      </sx:div>          
      <sx:div id="tab2"  label="Tab 2" cssStyle="height:100px;" href ="index.jsp"  refreshOnShow="true">        
          Local Tab 2       
      </sx:div>          
      <sx:div id="tab3"  label="Tab 3" disabled="true">        
          Local Tab 3       
      </sx:div>   
</sx:tabbedpanel>    

closable：设置该tab标签是否可关闭。
href：加载资源。若为jsp页面，则加载该页面到该tab中。
preload：设置是否预先加载，默认为true。
cssStyle：用于设置tab选项卡大小。
refreshOnShow：设置是否每次单击选项卡重新加载内容，默认为false。
disabled：设置选项卡是否失效，默认为false。
labelposition：设置选项卡标头的显示位置，可以是top, right, bottom, left。
selectedTab：设置默认选中的选项卡。

原文链接地址：http://blog.csdn.net/czw2010/article/details/8161230

参考：
[1] http://struts.apache.org/docs/tag-reference.html