Struts2的模板和主题介绍
Struts2的模板和主题介绍
关键字: 模板 主题
?
将该文件放在Web应用的WEB-INF\classes\template\lee路径下,这表明创建了一个自定义模板,该模板名为lee。
除此之外,还必须在主题目录下增加一个theme.properties文件,该文件指定自定义模板是以哪个模板为基础进行扩展的,文件内容为:
Struts2提供的ajax主题就是以xhtml主题为基础进行扩展的。
Struts2的内建主题
Struts2内建了4个主题,分别是simple,xhtml, css_xhtml和ajax。
simple主题是最简单的主题,它是最底层的结构,主要用于构建附加的功能或者行为(例如在此主题基础上进行扩展),使用simple主题时,每个UI标签只生成一个简单的HTML元素,不会生成其他额外的内容。
Struts2的xhtml, css_xhtml主题都是对simple主题的包装和扩展。
xhtml主题是Struts2的默认主题,它对simple主题进行扩展,在该主题的基础上增加了如下附加的特性:
1,针对HTML标签(如textfield和select标签)使用标准的两列表格布局。
2,每个HTML标签的Label,即可以出现在HTML元素的左边,也可以出现在上边,这取决于labelposition属性的设置。
3,自动输出校验错误信息。
4,输出JavaScript的客户端校验。
css_xhtml主题则对原有的xhtml主题进行了扩展,在xhtml主题基础上加入了CSS样式控制。
ajax主题目对xhtml主题目进行了扩展,在xhtml主题上为每个标签提供了额外的Ajax支持。ajax主题的Ajax支持是以Dojo和DWR为基础的。ajax主题在xhtml主题基础上增加了如下特性:
1,支持Ajax方式的客户端校验。
2,支持远程表单的异步提交(最好和submit标签一起使用)。
3,提供高级的div标签,允许实现局部更新部分HTML的功能。
4,提供高级的a标签,允许动态加载并执行远端的javaScript代码。
5,提供支持ajax的tabbedPanel。
6,提供"富客户端"模型的pub-sub事件模型。
5,Struts2的表单标签
所有的表单标签可以分为两种:form标签本身和单个表单元素的标签。Struts2的表单元素标签都包含了非常多的属性。但有很多属性完全是通用的。
表单标签的通用属性
所有表单标签处理类都继承了UIBean类,UIBean包含了一些通用属性,这些通用属性分成3种:
1,模板相关属性;2,javascript相关属性;3,通用属性。
除了这些属性之外,所有的表单元素标签都存在一个特殊的属性:form,这个属性引用表单元素所在的表单,通过该form属性,可以实现表单元素和表单之间的交互。例如,我们可以通过${parameters.form.id}来取得表单元素所在表单的ID。表单标签的通用属性有以下几类:
1,模板相关的通用属性:可以指定该表单标签所用的模板和主题。
2,javascript相关的通用属性:指定在鼠标在该标签上操作时的javascript函数。
3,设置表单元素的提示:当鼠标在这引动元素上时,系统将出现提示。Struts2将这种特性称为Tooltip。
4,设置表单元素的CSS样式。
表单标签的name和value属性
name属性会映射到Action中的属性名称,value属性则代表此属性的值。例子如下:
<!-- 将下面文本框的值绑定到Action的person属性的firstName属性 -->
<s:textfield name="person.firstName" />
<!-- 使用表达式生成表单元素的值 -->
<s:textfield name="person.firstName" value="${person.firstName}" />
实际上Struts2已经自动处理了属性内容的赋值工作,因此我们只需要使用第一种方式就可以了。
checkboxlist标签
checkboxlist标签可以一次创建多个复选框,用于一次生成多个HTML标签中的<input type="checkbox">,它根据list属性指定的集合来生成多个复选框。因此使用该标签要指定一个list属性。其它都是通过属性,但是有两个常用属性:
1,listKey:该属性指定集合元素中的某个属性作为复选框的key
2,listValue:该属性指定集合元素中的某个属性作为复选框的value
下面是一个JSP页面的例子:
?
combobox标签
combobox标签生成一个单行文本框和下拉列表框的结合,但两个表单元素只对应一个请求参数,只有单行文本框里的值才包含请求参数,而下拉列表框则只是用于辅助输入,并没有name属性,也就不会产生请求参数。使用该标签时,需要指定一个list属性,该list属性指定的集合将用于生成列表框。例子如下:
通过访问上面的JSP页面,我们可以看到上面的文本框,用户可以自行输入,可也以选择下面的checkbox中的内容来进行输入。需要注意的是,此时的下拉列表仅仅是用于辅助输入的,并没有任何实际意义,因此不能指定它的listKey和listValue属性。?
?
datetimepicker标签
datetimepicker标签生成一个日期,时间下拉选择框,当我们使用该日期,时间选择框选择某个日期,时间时,系统会自动将选中的日期,时间输入指定的文本框。系统将指定日期,时间输入指定文本框时,必须转换成日期,时间字符串,为了设置该字符串的格式,必须使用日期,时间的格式符。datetimepicker使用例子如下:
?
doubleselect标签
doubleselect标签会生成一个级联列表框(两个下拉列表框),当选择第一个下拉列表框时,第二个下拉列表框中的内容会随之改变。使用例子如下:
?
默认情况下,第一个下拉列表框只支持两项,如果超过两项则不能这样处理。
我们可以先定义一个Map对象,该Map对象的value都是集合,这样就能以Map对象的多个key创建一个下拉列表框的列表项,而每个key对应的集合则用于创建第二个下拉列表框的列表项。例子如下:
?
从访问看到的效果来看,结果并不理想。还可以直接用javascript代码来实现以上效果,这里就不给出代码了。自己去思考一下。
head标签
head标签主要用于成生HTML主要页面的HEAD部分。国为有些主题需要包含特定的CSS和javascript代码,而该标签则用于生成对这此CSS和javaScript代码的引用。
例如,如果需要在页面中使用ajax组件,则使用一个带theme="ajax"属性的head标签,就可以将标准Ajax的头信息包含在页面中。
使用Ajax主题时,可以通过设置head标签的debug参数为true,从而打开调试标志。
一般使用Struts2的UI标签,javascript客户端校验等需要javascript库和CSS支持功能时,都应该先使用head标签。这个标签没有其它特别的用法,前面也已经使用过了。不再写例子。
optiontransferselect标签
optiontransferselect标签会创建两个选项用来转移下拉列表项,该标签会生成两个<select>标签,并且会生成系列的按钮,这系列的按钮可以控制选项在两个下拉列表之间移动,升降,当提交该表单时,两个<select>标签的请求参数都会被提交。例子代码如下:
?select标签
select标签用于生成一个下拉列表框,通过为该元素指定list属性,系统会使用list属性指定的集合来生成下拉列表框的选项。这个list属性指定的集合,即可以是普通集合,也可以是Map对象,还可以是集合中的对象的实例。例子如下:
?
radio标签
radio标签的用法与checkboxlist的用法几乎完全相同,一样可以指定label, list, listKey, listValue等属性。例子代码如下: