`
newleague
  • 浏览: 1492685 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类

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

 
阅读更多

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文件代码如下:

<!--?加入自己的文字部分 -->

<h3>作者李:</h3>


<!--?包含xhtml主题下的controlheader.ftl模板 -->

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

<!--?包含simple主题下的select.ftl模板 -->

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

<!--?包含xhtml主题下的controlfooter.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

* @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 prefix="s" uri="/struts-tags"%>

<html>

<head>

<meta http-equiv="Content-Type"content="text/html; charset=GBK"/>

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

分享到:
评论

相关推荐

    struts2 theme主题

    通常,使用Struts2主题涉及以下几个步骤: 1. **配置主题**:在struts.xml配置文件中,可以指定全局主题或者在Action配置中指定特定Action的显示主题。例如: ```xml &lt;struts&gt; &lt;constant name="struts.ui.theme...

    Struts2_自定义标签的方法

    ### Struts2自定义标签详解 #### 一、引言 在Web开发中,Struts2框架...总之,Struts2自定义标签的实现涉及UIBean、JSP Tag和Template三个关键组成部分,通过合理的规划和设计,可以极大地方便Web应用的开发和维护。

    Struts2源码分析

    Struts2提供了一系列增强的组件,位于`org.apache.struts2.components`包中,包括updownselect、doubleselect、datetimepicker、token、tree等,这些组件增强了用户体验,并且支持主题(theme)以自定义页面样式。...

    struts2错误显示

    2. **修改模板文件**:进一步自定义错误信息的显示格式,则需要修改Struts2的模板文件`fielderror.ftl`。 - **步骤**: 1. **解压模板文件**:从Struts2的核心库中解压`fielderror.ftl`文件,并将其放入项目的`WEB...

    Struts2属性文件详解

    指定了Struts 2应用加载的用户自定义属性文件,自定义属性文件中的设置不会覆盖`struts.properties`文件中的配置。如果需要加载多个自定义属性文件,可以使用英文逗号`,`分隔文件名。 #### struts.mapper.class 该...

    Struts2与FreeMarker模板

    通过将Struts2的模型数据传递给FreeMarker模板,前端开发人员可以使用FreeMarker提供的丰富的模板标签和函数来渲染页面。 #### 配置Struts2与FreeMarker 在Struts2中使用FreeMarker之前,首先需要进行相应的配置。...

    Struts小实例源码

    这些例子可能展示了如何配置和应用不同的主题到Struts2应用程序中,包括页面布局、CSS样式和模板。 2. **Struts2_2000_StrutsTags**: 这个文件名暗示了对Struts2内置标签库的使用。Struts2提供了一系列的JSP标签...

    struts2-layout

    Struts2-layout支持自定义主题和模板,主题决定了页面的样式,而模板定义了页面的结构。通过修改主题CSS和模板HTML,可以轻松地更改应用的外观和布局。 3. **动态内容插入**: 通过`&lt;s:include&gt;`标签,可以将动态...

    Java的Struts框架中的主题模板和国际化设置

    在Struts框架中,主题模板和国际化设置是非常重要的功能,它们可以帮助开发者定制应用的外观和语言支持。 首先,让我们深入了解一下主题模板。在Struts 2中,主题是指一系列预定义的样式和布局,用于控制UI标签(如...

    Struts2·0中文教程

    9. **主题和模板(Theme and Templates)**:Struts2支持多种模板引擎,如FreeMarker、Velocity等,可以自定义界面样式,实现视图层的灵活设计。 10. **Ajax支持**:Struts2能够很好地集成Ajax技术,通过SMD...

    struts 2 s标签 struts 2 s标签

    `s:component` 用于使用自定义标签,它可以与主题和模板配合使用。例如: ```jsp , 'J2EE' , 'Ajax'}" /&gt; ``` 11. **s:date** - 日期标签 `s:date` 用于格式化日期输入,还可以进行日期运算。例如,你可以...

    Struts 2 标签

    12. **Theme和CSS**: Struts 2支持多种主题和样式表,如xhtml、simple、ajax等,通过`theme`属性可以改变标签的外观。同时,可以使用`cssClass`和`cssStyle`属性为标签添加自定义的CSS样式。 13. **Tiles标签**: ...

    struts2标签chekboxlist实现竖排代码

    Struts2的标签支持自定义布局,通过设置`theme`属性,我们可以选择不同的主题或者提供自己的模板。默认的`simple`主题将复选框水平排列。为了竖排,我们可以创建一个新的主题或者修改现有的如`xhtml`或`css_xhtml`...

    struts2参数.txt

    允许开发者自定义额外的属性文件,这些属性可以覆盖或补充Struts2的默认行为。通常,这用于在项目中添加特定的配置项。 #### 十二、`struts.mapper.class` 用于映射HTTP请求到具体的Action。默认使用`org.apache....

    史上最全的struts2标签

    10. **conponent** 标签:这个标签用于使用自定义的标签或组件,通常需要指定`theme`、`templateDir`和`template`属性来定义样式和模板。 除了以上这些,Struts2还有其他诸如`textarea`、`textfield`、`select`、`...

Global site tag (gtag.js) - Google Analytics