Struts2的模板和主题theme及自定义theme

╰半橙微兮° 2022-07-28 01:45 28阅读 0赞

Struts2提供了三种主题，ajax, simple, css\_xhtml，xhtml，它默认的是xhtml主题，开发时我们一般都选simple。  
因为Struts2所有的UI标签都是基于主题和模板的，主题和模板是Struts2所有UI标签的核心。模板是一个UI标签的外在表示形式，例如：当我们使用<s:select ... ... />标签时，Struts2就会根据对应select模板来生成一个有模板特色的下拉列表框。如果为所有的UI标签都提供了对应的模板，那么这系列的模板就形成了一个主题。

对于一个JSP页面里包含的UI标签而言，即可以直接设置该UI标签需要使用的模板，也可以设置该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文件中确定。如：

<constantname="struts.ui.theme" value="simple" />

上面介绍的几种指定UI标签主题的方式，它们的优先级也是按照上面的顺序来的。

Struts2的模板目录是通过struts.ui.templateDir常量来指定的，该常量的默认值是template，即意味着Struts2会从Web应用的template目录，CLASSPATH(包括Web应用的WEB-INF\\classes路径和WEB-INF\\lib路径)的template目录来依次加载特定模板文件。如果我们只使用一个select标签，且指定主题为xhtml，则加载模板文件的顺序为：

1，搜索Web应用里/template/xhtml/select.ftl文件

2，搜索CLASSPATH路径下的template/xhtml/select.ftl文件

Struts2的模板文件是.ftl文件，它是FreeMarker的模板文件。用户也可以通过修改struts.ui.templateSuffix常量的值来改变Struts2默认的模板技术，该常量接受如下几个值：

ftl：基于FreeMarker的模板技术

vm：基于Velocity的模板技术

jsp：基于JSP的模板技术

虽然Struts2允许使用自己的模板技术，但如果用户选择了使用Velicoty或JSP作为模板技术，就要实现所有的模板和主题，这个是工作量很大的事情。

Struts2默认提供了4个主题：simple,xhtml,css\_xhtml和ajax，这4个主题的模板文件放在Struts2的核心类库里(struts2-core.jar包)。

n?用户也可以创建自己的主题  
创建自定义的主题有如下3种方式：

1，开发者完全实现一个全新的主题，这种方式要求开发者为每个UI标签都提供自定义的模板文件，不推荐

2，包装一个现有的主题，这种方式要求开发者为每个UI组件都提供自定义主题的模板文件，即使自定义主题里某个UI组件与原来主题里UI组件的行为完全一样。也不推荐。

3，扩展一个现有的主题，这种方式开发者只需要提供自定义的模板文件，例子如下：

用户自定义的主题是以xhtml主题为基础的，并且只想改变select UI标签的行为，则可以提供一个自己的select.ftl文件，并将该文件放在对应的主题目录下。

select.ftl文件代码如下：

<\#include"/$\{parameters.templateDir\}/xhtml/controlheader.ftl" />

<\#include"/$\{parameters.templateDir\}/simple/select.ftl" />

<\#include"/$\{parameters.templateDir\}/xhtml/controlfooter.ftl" />

将该文件放在Web应用的WEB-INF\\classes\\template\\lee路径下，这表明创建了一个自定义模板，该模板名为lee。

除此之外，还必须在主题目录下增加一个theme.properties文件，该文件指定自定义模板是以哪个模板为基础进行扩展的，文件内容为：

parent=xhtml

\#指定该主题以xhtml主题为基础进行扩展

该文件也放在WEB-INF\\classes\\template\\lee路径下，然后在JSP页面中使用如下代码就可调用此模板了：

<%--

\* @author yeeku.H.lee [kongyeeku@163.com][kongyeeku_163.com]

\* @version 1.0

\* <br>Copyright (C), 2005-2008, yeeku.H.Lee

\* <br>This program is protected by copyright laws.

\* <br>Program Name:

\* <br>Date:?

\--%>

<%@ page contentType="text/html; charset=GBK"language="java"%>

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

<html>

<head>

<title>使用自定义模板来生成下拉列表</title>

</head>

<body>

<s:select name="aa" theme="lee"?

list="\{'Spring2.0' , 'J2EE' , 'Ajax'\}" size="3"/>

</body>

</html>

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事件模型。

PS:http://newleague.iteye.com/blog/1139312

[kongyeeku_163.com]: mailto:kongyeeku@163.com
[taglib]: mailto:%@taglib

Struts2的模板和主题theme及自定义theme

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 IDEA - 官方定制主题，Dark Purple theme，Cyan Light Theme，Gray Theme

相关 jQuery UI API 类别 - 主题（Theming）

相关 Android主题theme和样式style总结

相关应用界面主题Theme使用方法

相关 android自定义theme尝试

相关 Struts2的模板和主题theme及自定义theme

相关 Android样式(style)和主题(theme)

相关 Laravel主题切换 — teepluss/theme

相关 android自带theme

相关乐曲主题Musical Themes