struts 2.0常用标签

1
struts 2.0
常用标签

1
struts 2.0
常用标签

1
struts 2.0
常用标签

一、
struts 2
．
0
标签库分类

在
Struts 1
．
0
的标签库中，它分别提供了
html
、
bean
、
logic
、
files
、
nested
这
5
个标签
库。
struts 2
．
0
标签库把所有标签整合到了一个标签库中。我们可以将
Struts 2
．
0
的标签库中
的标签分成
3
大类。

Struts 2
．
0
的标签库分类（三大类）

分类

描述

包括

UI
标签类

（页面控件）

主要用于生成
HTML
页
面元素。

1
、表单标签：主要用
于生成
HTML
中的表单。

2
、非表单标签：主要包含一些
常用的功能标签，
如显示日期。

非
UI
标签类

主
要
用于
数据
逻辑
输
出、数据访问等。

1
、数据标签：主要用于数据存
储和处理。

2
、逻辑控制标签：主要用于条
件，循环等流程控制。

Ajax
标签类

主要用于支持
Ajax
。

二、使用表单
UI
标签

通用属性
:
title
属性：该属性用来设置表单元素的
title
属性。

disabled
属性：该属性用来设置表单元素是否可用。

label
属性：该属性用来设置表单元素的
label
属性。

name
属性：该属性用来设置表单元素的
name
，该属性的值与
Action
中的属性名相对应。

value
属性：该属性用来设置表单元素的值。

例
1
：几个简单
UI
标签
(
见项目“
Tag
”
,
仅仅是页面的标签
,
没有处理提交
,)
Struts 2
．
0
的表单标签很多，其中一部分比较简单的标签是与
HTML
的标签相对应的。下
面的
JSP
文件包含了一些简单的表单标签，代码如下：

<%@

page

language
=
"java"

contentType
=
"text/html; charset=UTF-8"

pageEncoding
=
"UTF-8"
%>

<%@

taglib

prefix
=
"s"

uri
=
"/struts-tags"

%>

<!
DOCTYPE

HTML

PUBLIC

"-//W3C//DTD HTML 4.01 Transitional//EN">

<
html
>

<
head
>

<
title
>
This Page Illustrates Use of JSP UI Tags
</
title
>

</
head
>

<
body
>

<
s:form

action
=
""
>

<!--
选择文件：
-->

2

<
s:file

name
=
"file"

label
=
"
文件：
"

tooltip
=
"This is a File Input"

/>

<!--
提示条信息

-->

<!--
一组单选按钮：
-->

<
s:radio

name
=
"radio"

label
=
"
单项选择，岗位：
"

list
=
"{'Architect','Engineer','Coder'}"

tooltip
=
"This is a radioBox"
/>

<!--
下拉列表：
-->

<
s:select

name
=
"select"

label
=
"
下拉选择：
"

list
=
"{'Apple','Orange','Pear'}"
multiple
=
"true" //

列表中允许多选

tooltip
=
"This is your select"
/>

<!--
密码框：
-->

<
s:password

name
=
"password"

label
=
"
密码：
"

maxlength
=
"9"

required
=
"true"

tooltip
=
"Please enter password"
/>

3

<!--
列表：
-->

<
s:updownselect

name
=
"updownselect"

label
=
"
列表选择：岗位
"

list
=
"{'Architect','Engineer','Coder' }"

multiple
=
"true"
//
列表中允许多选

tooltip
=
"This is a Up down Select "
/>

<!--
文本域：
-->

<
s:textarea

name
=
"textarea"

label
=
"
文本域：
"

cols
=
"20"

rows
=
"3"

tooltip
=
"WriteSomething"
/>

<!--
一组复选框：
-->

<
s:checkboxlist

name
=
"checkboxlist"

label
=
"
复选框列表，职业：
"

list
=
"{'Architect', 'Engineer', 'Coder', 'Hay'}"

tooltip
=
"Choose the Job"
/>

<!--
组合框：
-->

<
s:combobox

name
=
"fruit"

4

label
=
"
组合框选择，水果：
"

list
=
"{'Apple','Orange','Pear'}"

tooltip
=
"this is the combobox"
/>

<!--
单个复选框：
-->

<
s:checkbox

name
=
"foo"

label
=
"
单个复选框：
"

tooltip
=
"Are you good at programming?"
/>

<!--
选项双向传递：
-->

<
s:optiontransferselect
//
提交时，这两个列表中选中的值都会被提交

label
=
"The most beautiful country"

rightTitle
=
"Eastern Counteries"

leftTitle
=
"Western Countries"

tooltip
=
"Select the Country you like most"

name
=
"LeftSideCountry"

list
=
"{'US.', 'UK', 'Germany'}"

headerKey
=
"headerKey"

headerValue
=
"--- Please Select ---"

emptyOption
=
"true"
//
表头与内容之间允许有空行

multiple
=
"true"
//
列表框中允许多选

doubleName
=
"RightSideCountries"

doubleList
=
"{'China', 'Korean', 'Japan'}"

doubleHeaderKey
=
"doubleHeaderKey"

doubleHeaderValue
=
"--- Please Select ---"

doubleEmptyOption
=
"true"
//
表头与内容之间允许有空行

doubleMultiple
=
"true"

/>
//
列表框中允许多选

5

</
s:form
>

<
br
><
br
><
br
><
br
>

</
body
>

</
html
>

6
运行结果：

例
2
：
datetimepicker
标签（见项目“
tagDateTime
”
）

该标签可以生成一个动态日历，
当单击文本框时就会弹出日历选择框供我们选择日期时间，
选
择日期后系统就会把选择的日期、时间输入到文本框中。

datetimepicker
标签的属性比较多，下面是比较常用的属性：

displayFormat
属性：该属性用来指定日期的显示格式，例如，可以指定
yyyy-mm-dd
作
为日期的显示格式。

displayWeeks
属性：该属性用来指定日历显示出星期数。

endDate
属性：该属性用来指定日历可以显示的最后日期，例如
endDate="2012-01"
表示
日历将不显示
2012-01-01
之后的日期。

language
属性：该属性用来指定日历显示的语言，例如我们需要显示简体中文，就指定
languag="zh_CN"
，简体中文；
languag=" en_US "
，英文。

startDate
属性：该属性正好与
endDate
属性相反，指定了某日期后，日历将不显示该值

7
之前的日期。

toggleDruation
属性：该属性用来指定日历选择框出现和隐藏的切换时间。

toggleType
属性：该属性用来指定日历选择框出现和隐藏时的切换效果，有
4
个值可选
择：
plain
、
wipe
、
explode
、
fade
。

。

。

type
属性：该属性用来指定选择框的类型，有
2
个值可供选择：
date
和
time
，分别表示日期
选择框和时间选择框。

value
属性：该属性用来指定当前日期、时间。

weekStartsOn
属性：该属性用来指定哪一天才是一周的第一天，默认周日是
0
。

必须为
head
标签指定
theme
属性（主题）的值为
ajax
，否则时间选择框不能正常显示：

即：
<s:head theme="ajax"/>
。

index.jsp:

<%@
page

language
=
"java"

pageEncoding
=
"UTF-8"
%>

<%@

taglib

prefix
=
"s"

uri
=
"/struts-tags"
%>

<
html
>

<
s:head

theme
=
"ajax"

/>

<
body
>

<
h2
>
datetimepicker
标签（日期、时间）
</
h2
>

<
s:form

action
=
"msg"
>

<
s:datetimepicker

name
=
"birthday"

label
=
"
出生日期
"

type
=
"date"

language
=
"zh_CN"
/>

<
br
><
br
><
br
>

选择日期：

8

<
s:datetimepicker

name
=
"recordtime"

label
=
"
记录时间
"

type
=
"time"

language
=
"zh_CN"
/>

<
s:submit

value
=
"
提交
"
></
s:submit
>

<
s:reset

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

选择时间：

</
s:form
>

</
body
>

</
html
>

运行结果：

提交前：

9

提交后
,
跳转到结果页面：

三、其它几个标签的应用见如下项目（有提交的处理）

“
tagCheckBox-String
”
、

之前的日期。

toggleDruation
属性：该属性用来指定日历选择框出现和隐藏的切换时间。

toggleType
属性：该属性用来指定日历选择框出现和隐藏时的切换效果，有
4
个值可选
择：
plain
、
wipe
、
explode
、
fade
。

。

。

type
属性：该属性用来指定选择框的类型，有
2
个值可供选择：
date
和
time
，分别表示日期
选择框和时间选择框。

value
属性：该属性用来指定当前日期、时间。

weekStartsOn
属性：该属性用来指定哪一天才是一周的第一天，默认周日是
0
。

必须为
head
标签指定
theme
属性（主题）的值为
ajax
，否则时间选择框不能正常显示：

即：
<s:head theme="ajax"/>
。

index.jsp:

<%@
page

language
=
"java"

pageEncoding
=
"UTF-8"
%>

<%@

taglib

prefix
=
"s"

uri
=
"/struts-tags"
%>

<
html
>

<
s:head

theme
=
"ajax"

/>

<
body
>

<
h2
>
datetimepicker
标签（日期、时间）
</
h2
>

<
s:form

action
=
"msg"
>

<
s:datetimepicker

name
=
"birthday"

label
=
"
出生日期
"

type
=
"date"

language
=
"zh_CN"
/>

<
br
><
br
><
br
>

选择日期：

8

<
s:datetimepicker

name
=
"recordtime"

label
=
"
记录时间
"

type
=
"time"

language
=
"zh_CN"
/>

<
s:submit

value
=
"
提交
"
></
s:submit
>

<
s:reset

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

选择时间：

</
s:form
>

</
body
>

</
html
>

运行结果：

提交前：

9

提交后
,
跳转到结果页面：

三、其它几个标签的应用见如下项目（有提交的处理）

“
tagCheckBox-String
”
、

10
“
tagComboBox-String
”

、

“
tagRadio-String
”、

“
tagSelect-String
”