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属性来指定主题。
  1. 通过设定特定UI标签外围的form标签的theme属性来指定主题。
  2. 通过取得page;request;session;application会话范围内以theme为名称的属性来确定主题。
  3. 通过取得名为struts.ui.theme的常量(默认值是xhtml)来确定主题,该常量可以在struts.properties文件或者struts.xml文件中确定。如:<constantname="struts.ui.theme" value="simple" />

上面介绍的集中指定UI标签主题的方式,他们的优先级也是按照上面的顺序来的。

Struts2的模版目录是通过<constant name="struts.ui.templateDir" value="template" />来指定的,该常量的默认值是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提供的四个主题的模版文件放在struts2的核心类库struts2-core.jar里。

内置主题介绍

Struts2内建了4个主题,分别是:

  • simple

    simple主题是最简单的主题,它是最底层的结构,主要用于构建附加的功能或者行为(例如在此主题基础上进行扩展),使用simple主题时,每个UI标签只生成一个简单的HTML元素,不会生成其他额外的内容。

  • xhtml

    xhtml主题是Struts2的默认主题,它对simple主题进行扩展,在该主题的基础上增加了如下附加的特性:

    1. 针对HTML标签(如textfield和select标签)使用标准的两列表格布局。
    2. 每个HTML标签的Label,即可以出现在HTML元素的左边,也可以出现在上边,这取决于labelposition属性的设置。
    3. 自动输出校验错误信息。
    4. 输出JavaScript的客户端校验。
  • css_xhtml

    css_xhtml主题则对原有的xhtml主题进行了扩展,在xhtml主题基础上加入了CSS样式控制。

  • ajax

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

自定义theme

创建自定义的主题有如下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主题为基础进行扩展的。

原文地址:http://newleague.iteye.com/blog/1139312

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,755评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,369评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,799评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,910评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,096评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,159评论 3 411
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,917评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,360评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,673评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,814评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,509评论 4 334
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,156评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,882评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,123评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,641评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,728评论 2 351

推荐阅读更多精彩内容

  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,603评论 18 399
  • 1.Struts标签 Struts2中定义一组新的标签库,使用struts的标签库和JSTL类似。 Struts2...
    MPPC阅读 452评论 0 3
  • 一. Java基础部分.................................................
    wy_sure阅读 3,807评论 0 11
  • 1.什么是框架 什么是框架,框架从何而来,为什么使用框架? 1).框架(framework)——半成品: 1.是一...
    贾里阅读 2,877评论 0 0
  • 中秋节快乐哈,大家~
    半开不落阅读 667评论 0 3