即日起在codingBlog上分享您的技术经验即可获得积分,积分可兑换现金哦。

【Struts2】Struts2学习与进阶(4)Struts2标签库

编程语言 u010583599 28℃ 0评论
本文目录
[隐藏]

Struts 2标签库的使用

Struts 2把所有标签都定义在一个s标签库里。从范围来分,Struts2 可以将所有标签分成如下三类。

UI(User Interface ,用户界面)标签:主要用于生成HTML元素的标签。

非UI标签:主要用于数据访问、逻辑控制等的标签。

Ajax标签:用于Ajax(Asynchronous JavaScript And XML)支持的标签。

表单标签:主要用于生成HTML页面的form元素,以及普通表单元素的标签。

非表单标签:主要用于生成页面上的树、Tab页等标签。

数据控制标签:主要包含用于实现分支、循环等流程控制的标签。

数据访问标签:主要包含用于输出ValueStack中的值、完成国际化等功能的标签。




导入Struts 2标签库


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

Struts 2 的OGNL表达式语言

在Struts 2 应用中,视图页面可通过标签直接访问Action属性值(实际这只是一种假象,类似Web应用保持application、session、request、page四个范围的“银行”,Struts 2 自行维护一个特定范围的“银行”,Action将数据放入其中,而JSP页面可从其中取出数据,表面上似乎JSP可直接访问Action数据)当Action属性不是简单值(基本类型或String类型值)时,而是某个对象,甚至是数组、集合时,就需要使用表达式语言来访问这些对象、数组、集合的内部数据,Struts
2 利用OGNL表达式语言来实现这个功能。OGNL不是真正的编程语言,只是一种数据访问语言。

 

在传统的OGNL表达式求值中,系统会假设只有一个“根”对象。

例:

系统的Stack Context中包含两个对象:foo对象和bar对象,且foo为Context的根对象。

//返回 foo.getBlash()的值
#foo.blah
//返回 bar.getBlash()的值
#bar.blah
//因为foo是根对象,所以默认取得foo对象的blash属性
blash
//返回bar.getFoo().getBlash()
#bar.foo.blash

如果需要访问的属性属于根对象,则可以直接访问该属性,如blash;否则必须使用一个对象作为前缀修饰该属性,如#bar.blash。Struts2 提供了一个特殊的OGNL Property Accessor(属性访问器),它可以自动搜寻Stack Context的所有实体(从上到下),直到找到与求值表达式匹配的属性。

例:假设 Stack Context 中包括两个根实例: animal和person,这两个实例中包含“name”属性,其中animal是栈顶元素,person实例在其后面。

通过索引来访问Stack Context中的对象

//返回animal.getName()的值,因为从第一个开始找,先找到animal实例
[0].name
//返回person.getName()方法的返回值,从第二个开始找,先找到person实例
[1].name

上面这种索引的方式并不是直接去的指定元素,而是从指定索引开始向下搜索。

OGNL的顶级对象是一个Context,这个Context对象就是一个Map类型实例,其根对象就是ValueStack,如果需要访问ValueStack里的属性,直接通过如下方式即可,不需要加#

${bar}

Struts 2还提供了其他的命名对象,这些对象都不是Stack Context 的“根”对象,它们只是存在于Stack Context中。所以访问这些对象时需要使用#前缀来指明。

parameters 对象:用于访问HTTP请求参数。例如#parameters[‘foo’]或#parameters.foo,用于返回调用HttpServletRequest的getParameter(“foo”)方法的返回值。

request对象:用于访问HttpServletReqeust的属性,例如#request[‘foo’]或#request.foo,用于返回调用HttpServletRequest的getAttribute(“foo”)方法的返回值。

session对象:用于访问HttpSession的属性,例如#session[‘foo’]或者#session.foo,用于返回HttpSession的getAttribute(“foo”)方法的返回值。

application对象:用于返回ServletContext的属性。例如#application[‘foo’]或#application.foo,用于返回调用ServletContext的getAttribute(“foo”)方法的返回值。

attr对象:该对象将依次搜索如下对象:PageContext HttpServletReqeust HttpSession ServletContext 中的属性。

当系统创建了Action实例后,该Action实例已经被保存到ValueStack中,不需要写#即可访问Action属性。在页面增加标签,登录该页面,点击链接就可以查看Value Stack和Stack Context 里的数据。

 

OGNL中的集合操作

创建List集合语法为

{e1,e2,e3 …}

创建Map类型集合

#{key1:value1,key2 : value2, …}

in 和not in ,其中in判断某个元素是否在指定集合中,not in 判断某个元素是否不在指定集合中。


   
     include
   
   
     not include
   
   
   
     not include
   
   
     include
   

OGNL取出子集时还有如下三个操作符

? : 取出所有符合逻辑的元素。

^ : 取出符合选择逻辑的第一个元素。

$ :取出符合选择逻辑的最后一个元素。

person.relatives.{? #this.gender == ‘male’} //取出person的所有性别为male的relatives集合

访问静态成员

为了让OGNL表达式可以访问静态成员,应该在 Struts2中将 struts.ognl.allowStaticMethodAccess设置为true。

OGNL表达式通过如下语法来访问静态成员

@className@staticField
@className@staticMethod(val …)

例:访问环境变量和圆周率

访问系统环境变量:
圆周率

控制标签

if、else if 、else 用于控制选择输出的标签。

append: 用于将多个集合拼接成一个新的集合。

generator: 它是一个字符串解析器,用于将一个字符串解析成一个集合。

iterator: 这是一个迭代器,用于将集合迭代输出。

merge: 用于将多个集合拼接成一个新的集合,顺序和append不同。

sort :用于对集合排序。

subset: 用于截取部分集合元素。

iterator 标签

使用标签对集合进行迭代输出时,可以指定如下三个属性。

1.      value : 可选属性,value属性指定的是被迭代的集合,被迭代的集合通常都使用OGNL表达式指定。如果没有指定value属性,则使用ValueStack栈顶的集合。

2.      id: 可选属性,该属性指定了集合里元素的ID。

3.      status :可选属性,该属性指定迭代时的IteratorStatus实例,通过该实例即可判断当前元素的属性,如是否是最后一个,当前元素索引等。

如果为指定status属性,每次迭代都会有一个IteratorStatus实例,该实例包含了以下几个方法。

intgetCount();返回当前迭代了几个元素。

intgetIndex();返回当前迭代元素的索引。

BooleanisEven();返回当前迭代元素的索引是否为偶数。

BooleanisFirst(); 返回当前迭代元素是否是第一个元素。

BooleanisLast();返回当前被迭代元素是否是最后一个元素。

BooleanisOdd();返回当前被迭代元素的索引是否是奇数。

append 标签

append标签用于将多个集合对象拼接起来,组成一个新的集合。

使用标签时需要指定一个var属性,该属性指定新集合的名字,该新集合被放在Stack Context 中。除此之外, 标签可以接受多个子标签,每个子标签可指定一个集合。


 
 

generator标签

generator可以将指定字符串分隔成一个Iterator集合。在该标签的标签体内,整个临时生成的集合将位于ValueStack 的顶端,但一旦该标签结束,该集合将被移出ValueStack。

1.      count: 该属性是一个可选属性,该属性指定生成集合元素的总数。

2.      separator: 必选属性,是定解析字符串的分隔符。

3.      val : 必填属性,指定被解析的字符串。

4.      converter: 可选属性,该属性指定一个转换器,该转换器负责将集合中的每个字符串转换成对象,通过该转换器可以将一个字符串解析成对象集合。该属性值必须是一个org.apache.Struts 2.util.IteratorGenerator.Converter对象。

5.      var: 可选属性,如果指定了该属性,则将生成的Iterator对象放入StackContext中(并且还会设置为request范围的属性)。

merge标签

merge类似append标签,不过merge拼接顺序和append不同。

subset标签

subset标签用于取得集合的子集,该标签的底层是通过org.apache.struts2.util.Subset IteratorFilter 类实现。

有如下几个属性:

1.      count:可选属性,指定子集中元素的个数。如果不指定该属性,则默认取得源集合的全部元素。

2.      source:可选属性,指定源集合,如果不指定该集合,则默认取得ValueStack栈顶的集合。

3.      start: 可选属性,指定子集从源集合的第几个元素开始截取。默认从第一个元素(默认值为0)

4.      decider:这是一个可选属性,该属性指定由开发者自己决定是否选中该元素。该属性必须指定一个org.apache.struts2.util.SubsetIteratorFilter.Decider 对象。

5.      var :可选属性,如果指定了该属性,则Iterator对象设置成page范围的属性,不放入StackContext中,和gererator不同。

在subset标签内时,subset标签生成的子集合放在ValueStack的栈顶,我们可以在该标签内直接迭代该标签生成的子集合。标签结束后,则子集合被移出ValueStack栈。

Struts2 允许开发者决定截取标准,需要实现Decider类,Decider类需要实现SubsetIteratorFilter.Decider接口,实现该类时,需要实现一个 Boolean decide(Object element)方法,如果该方法为真,则表明该元素将被选入子集中。

public class MyDecider 
 implements SubsetIteratorFilter.Decider
{
 //实现Decider接口必须实现的decide方法,
 //该方法决定集合中的元素是否被选入子集
 public boolean decide(Object element) throws Exception
 {
  String str = (String)element;
  //如果集合元素(字符串)中包含Java EE子串,即可被选入子集
  return str.indexOf("Java EE") > 0;
 }
}

使用自定义过滤规则





直接输出page范围的newList属性:
${pageScope.newList} style="background-color:#bbbbbb">

sort标签

sort标签对指定集合进行排序,必须提供自己的排序规则,实现自己的Comparator,自己的Comparator需要实现java.util.Comparator接口

sort标签可指定如下几个属性:

1.      comparator: 必选属性,该属性指定进行排序的Comparator实例。

2.      source:可选属性,指定被排序的集合。如果不指定该属性,则对ValueStack栈顶的集合排序。

3.      var : 可选属性,如果指定了该属性,则将生成的Iterator对象设置成page范围的属性,不放入StackContext中。

在sort标签内时,sort标签生成的子集合放在ValueStack的栈顶,可以在该标签内直接迭代输出子集合,该标签结束,则集合将被移出ValueStack栈。

例:

我们自己实现的排序规则类

public class MyComparator implements Comparator
{
 //决定两个元素大小的方法
 public int compare(Object element1, Object element2)
 {
  //根据元素字符串长度来决定大小 
  return element1.toString().length()
   - element2.toString().length();
 }
}

compare方法返回一个大于0的整数,则第一个元素大于第二个元素,如果该方法返回0,则两个元素相等,如果返回小于0的整数,则第一个元素小于第二个元素。




输出page范围的sortedList属性:
${pageScope.sortedList} style="background-color:#bbbbbb">

数据标签

数据标签主要用于提供各种数据访问相关的功能,主要包含如下:

action:该标签用于在JSP页面直接调用一个Action,通过指定executeResult参数,还可将该Action的处理结果包含到本页面中来。

bean:该标签用于创建一个JavaBean实例,如果指定了var属性,则可以将创建的JavaBean实例放入StackContext中。

date:用于格式化输出一个日期。

debug:用于在页面生成一个调试链接,单击该链接,可以看到当前ValueStack 和 StackContext中的内容。

i18n:用于指定国际化资源文件中的baseName。

include:用于在JSP页面中包含其他的JSP或Servlet资源。

param:用于设置一个参数,通常是用做bean标签、url标签的子标签。

push:用于将某个值放入ValueStack的栈顶。

set:用于设置一个新变量,并可以将新变量放入指定的范围内。

text:用于输出国际化消息。

url:用于生成一个URL地址

property:用于输出某个值,包括 ValueStack、StackContext 和ActionContext中的值。

action标签

使用action标签允许JSP页面直接调用Action,使用Action有如下几个属性。

1.      var : 这是一个可选属性,一旦定义了该属性,则Action将被放入ValueStack中。

2.      name : 这是一个必填属性,通过该属性指定调用哪个Action。

3.      namespace: 可选属性,指定调用Action所在的namespace。

4.      executeResult: 可选属性,指定是否要将Action的处理结果页面包含到本页面,默认是false,不包含。

5.      ignoreContextparams : 可选属性,指定页面的请求参数是否允许传入调用的Action,默认允许传入。

例:

TagAction.java

public class TagAction extends ActionSupport
{
 //封装用户请求参数的author属性
 private String author;
 //定义第一个处理逻辑
 public String execute() throws Exception
 {
  return "done";
 }
 //定义第二个处理逻辑
 public String login() throws Exception
 {
  ActionContext.getContext().
   put("author", getAuthor());
  return "done";
 }
}

配置struts.xml


 
  
   succ.jsp
  
  
  
   loginSucc.jsp
  
  
   .
  
 

使用Action标签调用aciton

下面调用第一个Action,并将结果包含到本页面中。

下面调用第二个Action,并将结果包含到本页面中。
但阻止本页面请求参数传入Action。

下面调用第三个Action,且并不将结果包含到本页面中。
本页面是否可访问?

在浏览器输出地址并传入 author参数

http://localhost:8080/Struts_Demo4/s-action.jsp?author=’xiaoming



bean标签

bean标签可以创建一个JavaBean实例。可以为该标签体内使用标签为该JavaBean实例传入属性,需要为JavaBean类提供对应的setter方法。

bean标签有如下两个属性:

1.      name:必选属性,指定要实例化的JavaBean的实现类。

2.      var:该属性是一个可选属性,如果指定了该属性,则JavaBean实例会被放入StackContext中,并放入requestScope中。

例:Person.java javabean类

public class Person
{
 private String name;
 private int age;
    …
}

使用bean标签


 
 
 
 
 Person实例的name为:
Person实例的age为:

使用bean标签,并使用var属性,在StackContext中访问



 
 
 


Person实例的name为:
Person实例的age为:
${requestScope.p}

date标签

date标签用于格式化输出一个日期。还可以计算指定日期和当前时刻之间的时差。

date标签有如下几个属性:

1.      format:可选属性,根据该属性指定的格式来格式化日期。

2.      nice:可选属性,只能为true或false,用于指定是否输出指定日期和当前时刻之间的时差。默认为false。

3.      name 必填属性,用于指定需要格式化的日期。

var: 可选属性,如果指定了该属性,格式化后的字符串将被放入Stack Context中,并放入requestScope中,但不会在页面输出。


nice="false",且指定format="dd/MM/yyyy"

nice="true",且指定format="dd/MM/yyyy"

指定nice="true"

nice="false",且没有指定format属性

nice="false",没有指定format属性,指定了var

${requestScope.abc}

输出结果:



include标签

include标签用于将一个JSP页面,或者一个Servlet包含到本页面中。该标签有如下属性:

1.      value :必选属性,该属性指定需要被包含的JSP页面,或者Servlet。

使用include标签





 

include-file.jsp

1.被包含的页面

author参数值为:${param.author}

使用 可以向被包含的页面传输参数。

push标签

push标签用于将某个值放到ValueStack的栈顶。其属性为:

value: 必填属性,指定需要放到ValueStack栈顶的值。


 使用s:push来将某个值放入ValueStack的栈顶


1.1.使用s:push来将某个值放入ValueStack的栈顶

ValueStack栈顶对象的name属性:
ValueStack栈顶对象的age属性:



set标签

set 标签用于将某个值放入指定范围内,如application范围,session范围。

当某个值所在对象图深度非常深时如animal.type.deatil.age,每次访问该值性能低下,可读性也不好,所以我们可以把它设置为一个新值,放入指定的范围里。

set标签有如下属性:

1.      scope: 可选属性,指定变量被放置的位置,可接受applicationsession  request page action 5个值,默认为action。

2.      value: 可选属性,指定将覆盖变量的值,如果不指定,则将ValueStack栈顶的值赋给变量。

3.      var:可选属性,如果指定了该属性,则会把该值放入ValueStack中。

如果指定action范围,则该值将要被放入request范围中,并放入OGNL的StackContext中。

例:


1.1.使用s:set设置一个新变量

将Stack Context中的p值放入默认范围(action)内。
Stack Context内xxx对象的name属性:
Stack Context内xxx对象的age属性:
request范围的xxx对象的name属性:${requestScope.xxx.name}
request范围的xxx对象的age属性:${requestScope.xxx.age}
将Stack Context中的p值放入application范围内。
application范围的yyy对象的name属性:${applicationScope.yyy.name}
application范围的yyy对象的age属性:${applicationScope.yyy.age}
将Stack Context中的p值放入session范围内。
session范围的zzz对象的name属性:${sessionScope.zzz.name}
session范围的zzz对象的age属性:${sessionScope.zzz.age}



url标签

url标签用于生成一个URL地址,可以通过为url标签指定param子元素,从而向指定URL发送请求参数,该标签有如下属性。

1.      action:可选属性,指定生成URL的地址为那个Action,如果Action不提供,使用value作为URL的地址值。

2.      anchor:可选属性,指定URL的锚点。

3.      encode:可选属性,指定是否需要对参数进行编码,默认是true。

4.      forceAddSchemeHostAndPort : 可选属性,指定是否需要在URL对应的地址里强制添加schema、主机和端口。

5.      includeContext:可选属性,指定是否需要将当前上下文包含在URL地址中。

6.      includeParams:可选属性,该属性指定是否包含请求参数,该属性的属性值只能为none、get或者all。默认为get。

7.      method:可选属性,该属性指定Action的方法,当我们用Action来生成URL时,如果指定了该属性,则URL将链接到指定Action的特定方法。

8.      namespace:可选属性,指定命名空间,当用Action来生成URL时,如果指定了该属性,则URL将链接到此namespace的指定Action处。

9.      portletMode:可选属性,指定结果页面的portlet模式。

10.  scheme:可选属性,用于设置scheme属性。

11.  value:可选属性,指定生成URL的地址值,如果value不提供就用action属性指定的Action作为URL地址。

12.  var:可选属性,如果指定了该属性,会把该链接值放入Struts2的ValueStack中。该属性可用id替换

13.  windowState:可选属性,指定结果页面的portlet的窗口状态。

 

property标签

property标签用于输出value属性指定值,如果没有指定value属性,则默认输出ValueStack栈顶的值。该标签有如下属性。

default:可选属性,如果需要输出的属性值为null,则显示default属性默认的值。

escape:可选属性,指定是否escapeHTML代码。默认是true。

value:可选属性,指定需要输出的属性值,如果没有指定该属性,则默认输出ValueStack栈顶的值。

 

主题和模板

模板是UI标签的外在表现形式,把一系列的模板组织起来叫做主题。

设置主题的方法有如下几种:

1.      通过设置UI标签上的theme属性指定主题。

2.      通过设定特定UI标签外围的Form标签的theme来指定主题。

3.      通过取得page会话范围内命名为theme的属性来确定主题。

4.      通过取得request会话范围内命名为theme的属性来确定主题。

5.      通过取得session会话范围内命名为theme的属性来确定主题。

6.      通过取得application会话范围内命名为theme的属性来确定主题。

7.      通过设置名为 struts.ui.theme的常量(默认是xhtml)来确定默认主题,该常量可以在struts.properties或 struts.xml中确定。

以上方式优先级由高到低。

Struts2de模板目录是通过struts.ui.templateDir常量来指定的,该常量的默认值是template。struts2 会从web应用的template目录、CLASSPATH(包括Web应用的WEB-INF/classes路径和WEB-INF/lib路径)的template目录来依次加载特定模板文件。

 

表单标签

 

struts2表单标签可分为两种:form标签和单个表单元素标签。

所有表单标签处理类都继承了UIBean类,UIBean包含了一些通用属性,分三种:

模板相关属性

         JavaScript相关属性

         通用属性

除这三个属性外,所有表单元素标签都存在一个特殊的属性:form,这个属性引用表单元素所在的表单,通过该form属性,可以实现表单匀速和表单之间的交互,可通过${parameters.form.id}来取得所在表单的id。

模板相关属性

templateDir: 指定该表单所用的模板文件目录。

theme : 指定该表单所用的主题

template: 指定该表单蟾宫的模板。

Javascript相关通用属性

onclick: 指定鼠标单击触发的函数。

ondbclick : 指定鼠标双击时触发的函数。

onmousedown: 指定鼠标在标签上按下时触发的函数

onmouseup: 指定鼠标松开时触发的函数。

onmouseover : 指定鼠标悬停时触发的函数。

onmouseout: 指定鼠标移出标签时触发的函数。

onfocus: 指定标签得到焦点时触发的函数。

onblur: 指定标签失去焦点时触发的函数。

onkeypress : 指定单击键盘上某个键时触发的函数。

onkeyup : 指定松开键盘上某个键时触发的函数。

onkeydown: 指定按下键盘上某个键时触发的函数。

onselect: 对下拉列表项等可以选择表单元素,指定选中该元素时触发的JavaScript函数。

onchange: 对于文本框等,指定当值改变时触发的函数。

 

Struts 2允许为表单元素设置提示,当鼠标在这些元素上悬停时,系统将出现提示。与Tooltip相关的通用属性如下:

tooltip :设置此组件的Tooltip

tooltipIcon : 设置Tooltip 图标的URL路径。

tooltipAboveMousePointer: 是否在光标位置上显示Tooltip。

tooltipBgColor: 设置Tooltip 的背景色。

tooltipBgImg : 设置Tooltip的背景图片。

tooltipBorderWidth: 设置Tooltip边框宽度。

tootipBorderColor : 设置Tooltip边框颜色。

tooltipDelay : 设置显示Tooltip的时间延迟。

tooltipFixCoordinateX: 设置固定Tooltip在指定的X坐标上,与tooltipSticky 属性结合使用

tooltipFixCoordinateY: 设置固定Tooltip在指定的Y坐标上,与tooltipSticky 属性结合使用

tooltipFontColor : 设置Tooltip 的字体颜色。

tooltipFontFace : 设置Tooltip的字体。

tooltipFontSize: 设置Tooltip的字体大小。

tooltipFontWeight: 设置Tooltip是否使用粗体。

tooltipLeftOfMousePointer: 设置在光标左侧显示Tooltip,默认为右侧。

tooltipOffsetX: 设置Tooltip相对光标位置的水平位移。

tooltipOffsetY: 设置Tooltip 相对光标位置的垂直位移。

tooltipOpacity : 设置Tooltip的透明度,可以是0(完全透明)到100(不透明)之间的数字。

tooltipPadding: 指定Tooltip的内部间隔。边框和内容之间的距离。

tooltipShadowColor: 使用指定的颜色为Tooltip创建阴影。

tooltipShadowWidth: 使用指定的宽度为Tooltip创建阴影。

tooltipStatic: 设置 Tooltip是否随着光标的移动而移动。

tooltipSticky: 设置Tooltip是否一直停留在它初识的位置,直到另一个Tooltip被激活,或点击了HTML页面。

tooltipStayAppearTime: 指定一个Tooltip消失的时间间隔。

tooltipTextAlign: 设置Tooltip 的标题和内容的对齐方式,可以是right、left、justify(居中对齐)

tooltipTitle: 设置Tooltip的标题文字。

tooltipTitleColor: 设置Tooltip的标题文字颜色。

tooltipWidth: 设置Tooltip的宽度。

 

其他通用属性        

cssClass : 设置该表单元素的class属性。

cssStyle: 设置表单的style属性,使用内联CSS样式。

title:设置表单元素的title属性。

disabled: 设置表单元素的disabled属性。

label : 设置表单元素的label属性

labelPosition : 设置表单元素的label所在位置,可设置为 top和left,默认是左边。

requiredposition: 定义必填标记(默认以“*” 作为必填标记)位于label元素的位置,可以是left和right,默认是右边。

name: 定义表单元素的name属性,该属性值用于与Action的属性形成对应。

required: 定义是否在表单元素的label上增加必填标记,设置为true是必填,默认是“*”

tabIndex : 设置表单元素tabindex 属性

value : 设置表单元素value属性

 

checkboxlist标签

checkboxlist 可以一次创建多个复选框,它有如下属性

list: 指定生成多选框的集合。

listkey : 指定集合元素中的某个属性(如person实例的name属性)作为复选框的value。如果集合时Map,则可以使用key和value值来指定复选框的value。

listValue : 同上,指定复选框的标签。

doubleselect标签

list  listKey listValue doubleList  doubleListKey doubleListValue 用法同 checkboxlist标签

doubleName : 指定第二个下拉列表框的name属性。

使用doubleselect标签时,必须放在标签中使用,且必须为该标签指定action属性。还需要在 struts.xml 中配置action

    /{1}.jsp

head标签

生成HTML的HEAD部分。一般使用Struts2的UI标签、JavaScript客户端校验等需要JavaScript库和CSS支持功能时,都应该先使用head标签。

optiontransferselect标签

生成两个列表选择框,并可以控制各个选项在两个列表项之间的移动、升降,当提交时两个选择框的参数都会被提交。

addAllToLeftLabel: 设置全部移动到左边按钮上的文本。

addAllToRightLabel:设置全部移动到右边按钮上的文本。

addToLeftLabel: 设置向左移动按钮上的文本。

addToRightLabel : 设置向右移动按钮上的文本。

allowAddAllToLeft: 设置是否出现全部移动到左边的按钮。

allowAddAllToRight: 设置是否出现全部移动到右边的按钮。

allowAddToLeft: 设置是否出现移动到左边的按钮。

allowAddToRight: 设置是否出现移动到右边的按钮。

leftTitle: 设置左边列表框的标题。

rightTitle: 设置右边列表框的标题。

allowSelectAll: 设置是否出现全部选择按钮。

selectAllLabel: 设置全部选择按钮上的文本。

doubleList: 设置用于创建第二个下拉选择框的集合。

doubleListKey: 设置创建第二个下拉选择框选项的value属性。

doubleListValue: 设置创建第二个下拉选择框的选项label属性。

doubleName: 设置第二个下拉选择框的name属性,必填属性。

doubleValue:设置第二个下拉选择框的value属性。

doubleMultiple: 设置第二个下拉选择框是否允许多选。

list: 设置用于创建第一个下拉选择框的集合。必填属性。

listKey: 设置创建第一个下拉选择框的选项value的属性。

listValue: 设置第一个下拉选择框的选项的label属性。

name:设置第一个下拉选择框的name属性。

value: 设置第一个下拉选择框的value属性。

multiple: 设置第一个下拉选择框是否允许多选。

select

生成一个下拉列表框,使用该标签必须指定list属性。list属性指定的集合,可以是普通集合,也可以是Map对象。常用属性:

listKey:指定value值。

listValue: 指定标签值。

multiple: 设置是否允许多选。

radio

radio标签与checkboxlist用法几乎完全相同,一样可以指定label、list、listKey和listValue等属性。radio生成多个单选按钮。

optgroup

optgroup 用于生成一个下拉列表框的选项组,因此该标签必须放在标签中使用。一个下拉列表框中可包含多个选项组,因此可以在一个标签中使用多个标签。除了list listKey listValue等属性外, optgroup还有label属性,该属性是选项组的组名。

token

token标签能阻止多次提交表单的问题(避免刷新页面导致的多次提交)。如果需要改标签起作用,还需要在Struts2的配置文件中启用TokenInterceptor拦截器或TokenSessionStoreInterceptor拦截器。该标签无须指定任何属性。

默认情况下,token标签生成的隐藏域的name为struts.token 因此,不要在表单中另外再定义一个名为struts.token的表单域。

updownselect

该标签类似于select标签的用法,区别是该标签生成的列表框可以上下移动选项。除了list listKey listValeu 它还支持如下几个属性。

allowMoveUp: 是否显示上移按钮,默认是true

allowMoveDown: 是否显示下移按钮,默认是true

allowSelectAll: 是否显示全选按钮,默认是true

moveUpLabel: 设置上移按钮上的文本,默认^符号

moveDownLable: 设置下移按钮上的文本,默认v符号

selectAllLabel: 设置全选按钮上的文本,默认是*符号。

 

非表单标签

actionerror 和 actionmessage

这两个标签用法完全一样,作用也几乎完全一样,都是负责输出Action实例里封装的消息;区别是一个输出 getActionErrors()信息,一个输出getActionMessage()信息。

component

component 标签可用于创建自定义视图组件,如果开发者需要经常使用某个效果片段,可以考虑吧这个效果片段做成一个视图组件,然后在页面中使用component标签来使用该自定义组件。使用component标签时,可以指定如下三个属性。

theme: 自定义组件所使用的主题,如果不指定,默认xhtml主题。

templateDir: 指定自定义组件的主题目录,如果不指定,则默认使用系统的主题目录 template目录。

template: 指定自定义组件所使用的模板。

component标签内可以使用param子标签,子标签向该标签模板中传入额外的参数。如果希望在模板中取得该参数,则可以用 $parameters.paramName 或者 $parameters[‘paramName’]形式。



Demo 地址 





























































转载请注明:CodingBlog » 【Struts2】Struts2学习与进阶(4)Struts2标签库

喜欢 (0)or分享 (0)
发表我的评论
取消评论

*

表情