Struts2的标签库

Struts2的标签分为下面几类:

  1. 控制标签
  2. 数据标签
  3. 表单标签
  4. 非表单标签
  5. Ajax标签

其中控制标签与数据标签为普通标签,表单标签、非表达标签与Ajax标签为UI标签。

 

 

 

 

 Struts 2标签库及其处理类被放在struts2-core-xxx.jar包中。

 要使用Struts2的标签库需在jsp页面中引入

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

 

 引入标签库后,在jsp中使用格式为:<s:xxxxx>  其中xxxxx是标签名 

 

 控制标签

控制标签主要用于流程的控制,实现分支、循环等操作,也可以完成对集合的合并、排序等操作。

if/elseif/else标签

这是三个标签是进行程序分支控制的,其中<s:if>标签可以单独使用,而<s:elseif>和<s:else>标签使用前必须有<s:if>标签,与java中 if 的用法一致。

标签用test属性进行条件判断,其值为boolean类型的表达式。

<s:if test="表达式">
    标签体
</s:if>
<s:elseif test="表达式">
    标签体
</s:elseif>
<s:else>
    标签体
</s:else>

 

append标签

append标签用来将多个集合对象拼接成一个集合,使用var或id属性指定新集合的名字(一般用var)。

<s:append var="newList">
    <s:param value="{'123', '456', '789'}"/>
    <s:param value="{'as', 'sd'}"/>
</s:append>
<s:iterator value="%{#newList}" id="lst">
    <s:property value="lst"/>
</s:iterator>

用新的名字取拼接后的集合。

 

 

generator标签

将指定字符串分割成多个子串,实际是转换成一个List集合,按顺序push到ValueStack中,如此就可以用<s:iterator>遍历。

标签属性:

 

 

iterator标签

对集合数据进行迭代遍历。

属性:

 

 

merge标签

将多个集合拼接成同一个集合。与append标签的用法相似,区别是二者拼接的结果集合的元素顺序不同。

两个集合进行拼接:{"abc", "def", "ghi"}、{"123", "456", "789"}

append拼接:

  {"abc", "def", "ghi", "123", "456", "789"}

merge拼接:

  {"abc", "123", "def", "456", "ghi",  "789"}

 

 

 sort标签

对指定集合元素进行排序,要提供自己的排序规则,即自定义一个实现Comparator的子类,并指定属性。 

 

 

 

subset标签

取出指定集合的子集, 

 

 

 

数据标签

a标签

 构造超链接

 

 

 

action标签

 用来在JSP页面中直接调用Action,其属性可以决定调用Action的name和namespace。若设置executeResult属性为true,则可以直接得到调用Action返回的视图页面。

 

 

 

bean标签

 用于创建一个JavaBean实例,通常与<s:param>标签结合使用,<s:bean>创建实例,<s:param>为该实例传入指定属性,因此指定javaBean必须提供对应的setter方法,要访问属性则提供getter方法。

 

 若不指定var属性,则该JavaBean实例只能在<s:bean>标签内访问。

 

date标签

用于输出指定格式的日期 

 

 

 

debug标签

用于输出ValueStack和StackContext中的信息,只有一个id属性,但一般不用。使用时直接将该标签添加到jsp页面中即可。 

 

i18n标签

用来进行资源绑定,然后将其放入ValueStack中。可以用来加载国际化资源文件,然后用<s:text>标签或在表单中使用key属性访问国际化资源文件。 

 

 

include标签

将一个jsp页面包含到该页面,有一个必需的value属性, 指定要包含的jsp页面。

<s:include>标签可以与<s:param>标签结合使用,当包含其他jsp页面时需要指定参数,就可以添加<s:param>将参数值传入,如此传值是用request方式传入,取值是需用request对象取或EL表达式,且<s:param>要指定name属性

<s:include value="two.jsp">
    <s:param name="name" value="jack">
</s:include>

 

 

param标签 

 用于为其他标签提供参数,如<s:bean>、 <s:include>

<s:param name="age">10</s:param><s:param name="age" value="10"/>

 

 

 

preperty标签

用于输出ValueStack中对象的属性值,可以使用value属性指定要输出的对象属性。

 

 

 若不指定value的属性值,则默认会输出ValueStack栈顶的值。

<s:property value="username" default="用户">

 

 

 

push标签

将一个值压入ValueStack的栈顶,可以方便的访问该值。该标签只有一个value属性。

<!-- push压入值栈栈顶,property取值 -->
<
s:push value="user"> <s:property value="firstName"/> <s:property value="lastName"/> </s:push>

 

 

 

set标签

 将某个值放入指定范围内,例如session、request等,其值通过scope属性来指定,scope属性值只能是application、request、session、page和action。

 

 

<!--放入action中-->
<s:set var="personName" value="person.name" />
<!--取值-->
<s:property value="#personName" />

 

 

 

 

text标签

用于输出国际化资源文件信息,jsp页面中用<s:i18n>指定国际化资源文件后,可以用<s:text>标签输入key对应的value。

 

 注意不能在一个标签中使用<s:text>标签

<!--无效-->
<s:textfield name="lastName" label="<s:text name="person.lastName"/>">

 

 

 

url标签

用于生成URL映射地址, 可以和<s:param>结合使用传入参数。

 

 

 

表单标签

form标签

<s:form>标签用于生成html的form,可以添加action、namespace等属性

 在form标签中一般包含其他表单标签,在提交时将其他表单标签的值作为参数传入服务器。

 

 

submit标签

<s:submit>标签可以生成html的提交按钮,用于<s:form>标签中,用于提交表单。

 (不知道为什么,method属性在测试使用中无效)

 

 

checkbox标签

创建复选框,等同于<input type="checkbox"/> 

与其他标签不同,value属性值为boolean类型,表示是否选中,fieldValue才是真值。

 

 

 

checkboxlist标签 

<s:checkboxlist>创建多个复选框。

 

 

 

combobox标签

用于创建文本框和下拉列表框的组合,看起来是两个组件,实际只有一个name属性,传入的请求参数为文本框中的值而不是列表框中的值。

 

 

 

doubleselect标签

创建两个相关联的列表框,即第二个列表框会根据第一个列表框的选择而变化(级联)。

 

 

 

file标签

<s:file>标签用于创建一个文件选择框,生成html的<input type="file">标签。

 一般用法:

<s:file name="uploadFile" accept="text/*">

 

 

 

hidden标签

<s:hidden>标签可以创建一个隐藏表单元素,生成html的<input type="hidden"/>,此标签不会显示在页面中,常用于提交表单时传递额外的参数。

<s:hidden name="id" value="%{id}">

 

 

 

inputtransferselect标签

主要用来获取输入转到列表框,或从列表中移除,实际该标签会创建多个表单元素的集合

 

 

 

label标签

 生成html的<label/>标签,XHTML主题下可以生成两个<label/>标签,位于一行的两列,左列起提示作用,右列用于显示Action属性数据;SIMPLE主题下只生成一个。  

<s:label name="name" value="Username">
<s:label name="address" value="Address">

 

 

 

optiontransferselect标签

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

 

 

 select标签

 可以创建一个下拉列表框,生成html的<select>标签

 

 

 

 

 

 optgroup标签

<s:optgroup>标签用于生成一个下拉列表框的选项组,通常该标签放在<s:select>标签中,作为选项,一个下拉列表可以包含多个选项组,所以一个<s:select>标签中可以包含多个<s:optgroup>标签。

 

 

 

 

 

 password标签

 创建密码输入框,用于输入密码,不显示明文。常用属性有name、size和maxlength,size指定密码输入框的显示宽度以字符数为单位,maxlength限定输入的最大字符个数。

<s:password label="Password" name="pwd" maxlength="15">

 

 

 

radio标签

用于生成多个单选框。

 

 

 

 

reset标签

创建一个重置按钮,用于重置表单内容。

<s:reset value="重置">

 

 

 

 textarea/textfield标签

两个标签都是创建文本框,区别是<s:textarea>创建的文本框是多行的,而<s:textfield>是单行的。

一般指定其name和value属性即可。

对于<s:textarea>还可以用cols和rows属性分别指定多行文本框的列数和行数。

 

 

token标签

<s:token>标签用于防止表单重复提交,实际在转换为html标签时 ,添加了一个隐藏域,存储了当前提交的值,由于每次提交的值都不一样,若拦截器在拦截信息时检测到两次提交表单时该隐藏域值相等,则阻止表单提交。

只需简单添加在表单元素中就行。

<s:form>
    <s:token/>
</s:form>

 

 

 

非表单标签

非表单标签主要用于输出在Action中封装的信息。

 

actionerror标签

输出错误信息到客户端,将Action中的信息输出到页面中,实际是Action实例中的getActionErrors()方法返回值

<s:actionerror/>

 

 

actionmessage标签

输出提示信息到客户端,实际是Action实例中的getActionMessage()方法返回值

<s:actionmessage/>

 

 

component标签

用于使用自定义的标签、模板、主题等。

 

div标签

生成html的<div>标签

 

fielderror标签

用于输出Action中的fieldErrors属性保存的字段错误,fieldErrors是一个Map类型的属性,在数据校验、类型转换发生错误时,相关的信息会存储在该Map中,通过该标签就可以输出这些信息。

<s:fielderror/>

 

 

 可以通过addActionErrors()、addActionMessage()、addFieldErrors()方法来手动添加信息,也可以通过上面的三个标签取对应数据。(这三个方法在Action中可以直接调用,是父类的方法)

 

posted @ 2020-04-08 19:20  originyuan  阅读(334)  评论(0编辑  收藏  举报