Struts标签库详解【2】

====================================================================

需要在head中用<s:head />标签

一、控制标签：

1 <s:if test=''></s:if>

<s:elseif test=""></s:elseif>

<s:else></s:else>：条件判断

id：(可选的)

test：(必须的，boolean)，决定是否显示if内的内容

test中可以用in/not in 判断

------------------------------

2 <s:property />：用于输出指定值

default：需要输出的属性值为null则显示该默认值(可选)

escape：指定是否格式化HTML代码(可选)

value：指定需要输出的属性值，如果没有指定则默认输出ValueStack栈顶的值(可选)

id：指定该元素的标识(可选)

------------------------------

3 <s:iterator />：用于对集合(List、Set、数组)进行迭代

value：指定被迭代的集合，若没有则使用值栈栈顶的集合(可选)

id：当前被迭代的元素

var:

status：指定迭代时的IteratorStatus的实例，其包含如下方法

int getCount():返回当前迭代了几个元素

int getIndex():返回当前迭代元素的索引

boolean isEven():返回当前被迭代元素的索引是否是偶数

boolean isOdd():返回当前被迭代的元素的索引是否是奇数

boolean isFirst():返回当前被迭代元素是否是第一个元素

boolean isLast():返回当前被迭代元素是否是最后一个元素

#status.even 是否偶数行

#status.odd 是否奇数行

#status.count 当前行数

#status.index 当前行的序号，从0开始[#status.count=#status.index+1]

#status.first 是否第一行

#status.last 是否最后一行

#status.modules(int) 当前行数取模

------------------------------

4 <s:append var="">

<s:param value=""/>

</s:append>

作为iterator的辅助使用，将多个(param标签表示的)集合合并，

var：表示新生成的集合

------------------------------

5 <s:generator val="%{'aaa,bbb,ccc,ddd,eee'}" count="3" separator=',' var="ge">

<s:iterator><s:property /><br /></s:property>

</s:generator>

可以将指定字符串按指定分隔符分隔成多个字符串，生成的多个字符串可以使用iterator标签迭代。

(该标签将一个字符串转换成list集合，在标签体内，临时生成的集合在值栈顶端，

标签结束后集合被移出值栈。)

val：指定被解析的字符串

count：可选，指定生成集合的数，若为3，生成的iterator只有val的前三项'aaa,bbb,ccc'；(可选)

var：(可选)，使用该属性后，可在后续JSP中通过request.getAttribute()来获取Iterator

或者OGNL中，#request.ge或者ge来获取，很多标签有此可选属性

separator：(必须)分隔符

convertor：(可选)

------------------------------

6 <s:sort comparator="" source="" >

...

</s:sort>：排序

comparator：必须，指定排序用的比较器

source：可选，需要排序的对象

------------------------------

7 <s:subset>

<s:iteraotr>...

</s:subset>：截取iterator的一部分(子集)，属性全部为可选

count：截取的数量

decider：决定是否将该元素选入子集(可实现过滤，写一个类实现SubsetIteratorFilter.Decider接口中

的boolean decide(Object element)方法，element代表当前判定的元素，如果该方法返回真，

则表明该元素element将被选入子集中)，被过滤掉的元素不计入count中，decider的值是上述类

的一个实例对象。

source：集合对象

start：集合中开始的位置

------------------------------

==============================

二、数据标签

1 <s:action>：可以允许在JSP页面直接调用Action，在调用的时候可以指定需要被掉用的Action的

namenamespace；如果指定了executeResult参数的属性为true，该标签会把Action的处理结果(就是result

所跳转的那个页面的内容)包含到本页面中。

id：可选，

name：必须的，Action的名字，

namespace：可选，所调用的Action的所在的namespace

executeResult：可选，指定是否将处理结果包含到本页面，默认false不包含

ignoreContextParam：可选，指定该页面的请求参数是否需要传入Action中，默认false传入参数

(ignore是忽视的意思)

------------------------------

2 <s:bean />：依据一个类生成一个javabean对象，可通过param标签传递参数

name：用于生成bean的Java类

var：可选，bean对象名

------------------------------

3 <s:date />：标签用于格式化日期

format：可选，指定格式 eg:

nice：可选，true/false；指定是否输出指定日期和当前时刻的时差，默认false不输出

name：必须，指定要格式化的日期

var/id：可选，将事件对象放入值栈，

------------------------------

4 <s:debug />：用于调试程序，显示信息

------------------------------

5 <s:i18n />：用于访问国际化资源文件的内容(文件名格式：name_zh_CN.properties，name为基本名)

name：指定资源文件的基本名(带范围)。

若文件放于src下则为全局的；放在包下则为包范围的；基本名和Action类的基本类名相同则为Action范围的

<s:text />：用于获取国际化资源文件的内容。

name：对应资源文件中的key

若为textfield获取的话，应该使用key属性对应资源文件的key，不能使用name属性

------------------------------

6、 <s:include value=""/>：导入一个JSP文件，value指定文件路劲名

------------------------------

7 <s:param name="" value="" />：给指定参数设置值

------------------------------

8、 <s:property />：输出值

------------------------------

9 <s:push />：可将程序员在ActionContext中引用的对象压入值栈中，为以后访问对象提供方便

value：指明需要压入值栈的对象

------------------------------

10 <s:set />：声明对象或者设置属性值

name/id/var：变量的名称

scope：范围，page,request,session,application,action，默认在request和ActionContext中

value：变量的值

------------------------------

11 <s:url var="myurl" action="abc" namespace="/uitag">

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

</s:url>：生成url

<s:a href="%{myurl}">a标签的链接</s:a>

action：该URL请求的action

namespace：该URL请求的ACTION所在的名空间

method：指明调用Action的什么方法

id/var：该url的ID，引用此URL时用到

生成的路劲为：/struts/uitag/abc.action?name=ljh

》注： %符号的用途是在标志的属性为字符串类型时，计算OGNL表达式的值，如value="%{#myurl}"《

<s:set name="Url" value="'http://www.baidu.com'" />

<s:a href="%{Url}">a标签的链接</s:a>

----------------------//<s:url value="#Url" /> //输出的是#myurl

<s:url var="url" value="%{#Url}" /> //输出的是http://www.baidu.com

<s:a href="%{url}">a标签的链接</s:a>

------------------------------

==============================

三、UI标签

----

templateDir：定义模版目录

theme：定义主题名字

template：定义模版名字

----

通用属性：

cssClass：定义CSS属性类

cssStyle：定义CSS属性

title：定义html title属性

disabled：是否失效

label：

labelPosition：label在form中的位置，从左从上计算

requiredPosition：定义必须的标签在Form中的位置

name：

required：在label上添加一个*

tabIndex：定义html tabIndex属性

value：

----------------

1 <s:checkbox name="" label="" value="" />

value：true/false，表示是否选中

<s:checkboxlist name="mylist" list="{'java','.net','php'}" value="{'java','php'}" />

list：复选框列的集合

name：复选框的名字

value：复选框默认选中的

theme：主题(共有属性)，struts2默认提供四种:simple、xhtml(默认)、css xhtml、ajax

<s:checkboxlist name="mymap" list="#{'a':'China', 'b':'English', 'c':'Canada'}" listKey="key" listValue="value" value="{'a','b'}" /> 如果集合中存放的是Javabean，则listKey和listValue的值可以直接用OGNL表达式，是bean的属性

------------------------------

2 <s:combobox />：生成一个单行文本框和一个下拉列表框，当行文本框用于输入(有请求参数)，

下拉框用于辅助输入(无请求参数)，没有实际意义

name：

label：

list：指定下拉框的值

headerKey：下拉框的头ID

headerValue：下拉框的头值

------------------------------

3 <s:radio name="mymap" list="#{1:'China',2:'English',3:'Canada'}" listKey="key" listValue="value" value="2" />表示2对应的默认选中

<s:radio name="mylist" list="{'java','php','c++'}" value="java" />表示java被默认选中

<s:radio name="r3" list="#attr.userList" listKey="id" listValue="name" />

------------------------------

4 <s:select name="mylist" list="{'java','php','c'}" value="java" multiple="" >

<s:optgroup label="数据库" list="{'oracle','mysql'}" />

</s:select>

其他类似单/复选框

multiple：boolean，是否多选

size：设置下拉框显示的选项个数

<s:optgroup label="数据库" list="{'oracle','mysql'}" />：作select的子标签用，在下拉框中分组显示

------------------------------

5 <s:doubleselect />：二级联动级联菜单

name：

list：

doublename：

doublelist：

label：

------------------------------

6 <s:optiontransferselect />：选项转移列表，生成左右两个列表框，可将一个的内容转到另一个

------------------------------

7 <s:updownselect />：可上下选择的select

lable：

name：

list：

emptyOption：boolean，是否加空白行，默认false

moveDownLabel：设置向下移动按钮的文本

moveUpLabel：设置向下移动按钮的文本

selectAllLabel：设置全选按钮的文本

allowMoveDown：

allowMoveUp：

allowSelectAll：是否可以全部选中，为false时selectAllLabel属性不可用

------------------------------

8 <s:token />：加入此标记防止表单重复提交

<s:form>

...<s:token /><s:submnit/>

</s:form>

需要启动两个拦截器：

<action ...>

<interceptor-ref name="defaultStack" />

<interceptor-ref name="token" />

<result name="invalid.token">...</result>

<result>...</result>

</action>

------------------------------

9 <s:textfield />：生成一个单行文本框

label：显示在文本框外面的提示文字，

value：

maxlength：输入的最大字符数

required：lable显示时加上一个*号(提示必填)

size：文本框的长度

readonly：只读

<s:textarea />：生成一个文本域

cols：

rows：

------------------------------

10 <s:file name="" accept="" />：文件选择标签

accept：指定文件的MIME类型

<s:label/>标签：

<s:submnit name="method:login" />标签：有三种类型

name：

type：指定类型，可以是submit/image/button

src：为image类型的时候指定路径，

action：指定处理的action

method：指定处理的action的方法

disabled：指定此表单是否不可用

预定义的前缀：method/action/redirect/redirect-action

method：取代action默认的execute方法(name="method:login")

action：取代form指定的action，导向另一个action(name="action:regist")

redirect：请求重定向到另一个URL，可以是应用程序外部的URL(name="redirect:http://www.baidu.com")

redirect-action：请求重定向到其他action

<s:reset />：生成一个重置按钮，input类型时不能用label只有用value

type：指定类型为button/input，默认input,

------------------------------

11 <s:form />

------------------------------

导入dojo插件包：<%@taglib uri="/struts-dojo-tags" prefix="sd" %>

必须在<head>中用<sd:head parseContent="true" />

四、Dojo插件包的标签

1 <sd:datetimepicker datetimepicker name="#session.user.birthday"

id="birthday" displayFormat="yyyy-MM-dd" />：日期选择控件

displayFormat：指定选中的日期生成的格式， yyyy-MM-dd

name：可以是OGNL表达式读取的后代的值(Date类型)

value：

------------------------------

2 <sd:tabbedpanelbl />：选项卡控件

------------------------------

3 <sd:textarea />：textarea控件，华丽的文本域

------------------------------