struts2之form标签theme属性详解

http://www.cnblogs.com/xiyuanbaiyun/archive/2012/05/25/2518525.html处转载

struts2中theme属性包括xhtml,html,simple,ajax 。默认是xhtml theme：设置struts2标签的主题，默认为xhtml。 theme=xhtml时：会默认额外生成tr,td。 theme=simple时：就生成标签所对应的html标签形式。 在默认情况下,表单元素是分布在不同行的。如下代码：             我们看着以上的代码跟HTML的差不了多少，但是因为struts2表单默认将表单内的每一个元素都分在单独的一行，label属性就如同我们在HTML 中在前面的文字标签一样。如果我们不想让它自动换行，那就应该写成如下格式： theme="simple">     label="用户名" name="username"/>     label="密码" name="password"/>     但在设置theme="simple"后,表单元素的label属性将失效，这时我们就得在表单元素前面加入想用label显示的文字。如： theme="simple">       用户名：label="用户名" name="username"/>       密码：label="密码" name="password"/>     此时显示的为将不在是label中的值，而是显示文本框前面的文字，按钮则显示它原来的默认值：sbumit。     以下为扩充知识： 1. 模板目录－＞主题目录－＞主题(模板文件) 这是模板/主题的目录组织方式。以实际为例，打开 struts2-core-2.x.x.jar 可以看到里面有一个 template，在 template 下有5个目录 ajax、css_xhtml、simple、xhtml 和 archive，其中前四个分别是 ajax、css_xhtml、simple、xhtml 主题的目录，每个主题目录中有各自的模板文件，主要是 ftl 文件，还有 css 和 js 文件。最后一个 archive 是归档的主题目录，其下又有 ajax、simple、xhtml、模板文件是 .vm 文件。由此可知 Struts2 大力推荐的模板语言是 FreeMarker，而不是 Velocity，以后要好好看看 FreeMarker，只知道 FreeMarkder 更 XML 化。 2. 上面看到模板目录名是 template，是 struts2-core-2.x.x.jar 中，其实目录名是由 struts.ui.templateDir 常量来指定的，只是默认值是 template。意味着 Struts 2 从 Web 应用的 template 目录或 CLASSPATH 的 template 目录(包) 中依次加载特定的模板文件。 3. 比如我们使用一个 select 标签，且指定主题为 xhtml，则加载模板文件的顺序为 (1) Web 应用/template/xhmlt/select.flt    (2) CLASSPATH/template/xhtml/select.ftl。Struts2 默认是用的 FreeMarkder 模板技术，可设置常量 struts.ui.templateSuffix 来改变默认的模板技术，可选值有 ftl、vm、jsp。但是对于 vm 和 jsp 要自己提供完整的实现，Struts2 可没帮你做这些。 4. 有时候我们想要自定义主题，如你希望输入框前的标签显示红颜色，你不想要校验错误提示在输入框正上方而是右边。当然你可以修改 struts2-core-2.x.x.jar 中 template 下某个主题的模板文件，或拷一份到 Web 应用目录的 template 目录修改要定制的模板，这样做总有些不爽。Struts2 还支持两种更灵活的主题定制方式。包装和继承现有主题，可以同时使用。 最简单的主题定制方式是利用主题模板的加载优先级，把自定义的模板文件放在优先级高的目录，比如放一个 text.ftl 在 WEB-INF/classes/template/xhtml/ 目录下，它将覆盖掉 struts2-core-2.x.x.jar 里的 template/xhtml/text.ftl 的定义。 5. 先看一个包装的例子，在 xhtml 下的 combobox.ftl 的内容如下： <#include "/${parameters.templateDir}/${parameters.theme}/controlheader.ftl" /> 2. 上面看到模板目录名是 template，是 struts2-core-2.x.x.jar 中，其实目录名是由 struts.ui.templateDir 常量来指定的，只是默认值是 template。意味着 Struts 2 从 Web 应用的 template 目录或 CLASSPATH 的 template 目录(包) 中依次加载特定的模板文件。 3. 比如我们使用一个 select 标签，且指定主题为 xhtml，则加载模板文件的顺序为 (1) Web 应用/template/xhmlt/select.flt    (2) CLASSPATH/template/xhtml/select.ftl。Struts2 默认是用的 FreeMarkder 模板技术，可设置常量 struts.ui.templateSuffix 来改变默认的模板技术，可选值有 ftl、vm、jsp。但是对于 vm 和 jsp 要自己提供完整的实现，Struts2 可没帮你做这些。 4. 有时候我们想要自定义主题，如你希望输入框前的标签显示红颜色，你不想要校验错误提示在输入框正上方而是右边。当然你可以修改 struts2-core-2.x.x.jar 中 template 下某个主题的模板文件，或拷一份到 Web 应用目录的 template 目录修改要定制的模板，这样做总有些不爽。Struts2 还支持两种更灵活的主题定制方式。包装和继承现有主题，可以同时使用。 最简单的主题定制方式是利用主题模板的加载优先级，把自定义的模板文件放在优先级高的目录，比如放一个 text.ftl 在 WEB-INF/classes/template/xhtml/ 目录下，它将覆盖掉 struts2-core-2.x.x.jar 里的 template/xhtml/text.ftl 的定义。 5. 先看一个包装的例子，在 xhtml 下的 combobox.ftl 的内容如下： <#include "/${parameters.templateDir}/${parameters.theme}/controlheader.ftl" /> 2. 上面看到模板目录名是 template，是 struts2-core-2.x.x.jar 中，其实目录名是由 struts.ui.templateDir 常量来指定的，只是默认值是 template。意味着 Struts 2 从 Web 应用的 template 目录或 CLASSPATH 的 template 目录(包) 中依次加载特定的模板文件。 3. 比如我们使用一个 select 标签，且指定主题为 xhtml，则加载模板文件的顺序为 (1) Web 应用/template/xhmlt/select.flt    (2) CLASSPATH/template/xhtml/select.ftl。Struts2 默认是用的 FreeMarkder 模板技术，可设置常量 struts.ui.templateSuffix 来改变默认的模板技术，可选值有 ftl、vm、jsp。但是对于 vm 和 jsp 要自己提供完整的实现，Struts2 可没帮你做这些。 4. 有时候我们想要自定义主题，如你希望输入框前的标签显示红颜色，你不想要校验错误提示在输入框正上方而是右边。当然你可以修改 struts2-core-2.x.x.jar 中 template 下某个主题的模板文件，或拷一份到 Web 应用目录的 template 目录修改要定制的模板，这样做总有些不爽。Struts2 还支持两种更灵活的主题定制方式。包装和继承现有主题，可以同时使用。 最简单的主题定制方式是利用主题模板的加载优先级，把自定义的模板文件放在优先级高的目录，比如放一个 text.ftl 在 WEB-INF/classes/template/xhtml/ 目录下，它将覆盖掉 struts2-core-2.x.x.jar 里的 template/xhtml/text.ftl 的定义。 5. 先看一个包装的例子，在 xhtml 下的 combobox.ftl 的内容如下： <#include "/${parameters.templateDir}/${parameters.theme}/controlheader.ftl" /> <#include "/${parameters.templateDir}/simple/combobox.ftl" />     <#include "/${parameters.templateDir}/xhtml/controlfooter.ftl" /><#nt/> 它就是对 simple/combobox.ftl 的基础上包装上一个 controlheader.ftl 和一个 controlfooter.ftl，包装的局限性是你仍然是要为每一个 UI 组件提供单独模板文件，即全套的。 和设计模式中的包装(装饰)模式如出一辙，如 BufferedInputStream 包装了 InputStream，但在 BufferedInputStream 提供了全套的和 InputStream 一样的操作方法。 6. 再说继承来自定义主题，如果简单改变个别 UI 的风格，继承就是最为高效的了。此继承与 Java 的继承(即extends) 也是一马事。要改变或要新加的用自己定义的，其他的延用父主题的。举个例子，自定义一个名为 custom 的主题继承自 xhtml，只改变 select 标签的风格，你要做的就是编辑自己的一个 select.ftl 放在 WEB-INF/classes/template/custom 下，并在此目录下放一文件 theme.properties，内容是: #指定该主题以 xhtml 为基础进行扩展 parent=xhml 使用可指定给 UI 标签，例如 默认是用的 xhtml/text.flt 模板，text.ftl 包装了 smple/text.ftl，错误信息可以追溯发现是在 controlheader-core.ftl 中定义显示的，所以你可以把 xthml/text.ftl 和 controlheader-core.ftl 拷到 WEB-INF/classes/template/xhtml 目录中进行修改，WEB-INF/classes/template/xhtml 中的模板文件是优先于 struts2-core-2.x.x.jar 里的 template/xhtml 目录中的模板文件加载。 10. 看有些地方只笼统介绍说：所有表单元素都存在一个特殊的属性：form，这个属性引用元素所在表单，通过该属性实现表单元素与表单间的交互，例如可通过 ${parameters.form.id} 访问表单的 ID。对这句话我只是感到一头雾水，查看像 等标签并无 form 属性，用 也看不到输出所在表单的 ID。去网上找找，才知道前面那句话有出入，其实说的是在主题模板文件里的用法，打开一些主题模板文件，如 combobox.ftl 或 controlheader-core.ftl 文件，你就能看到许多的 parameters 的表示法-- parameters.required、parameters.id。想见一下 parameters 属性才是根本，它代表了表单元素的属性集，parameters 说来还有点像 this，this.id、this.form.id、this.required 等等...       在用struts2开发项目的时候发现它总是会添加一些html标签在最终生成的html代码中，比如说使用标签，此时生成的html代码如下： 

     其中蓝色高亮部分是struts自动产生的，对于这些自动产生的东西有时候有用，但是对于有些项目确是不合适的，比如说我们的页面全部不允许加入table标签，或者需要用别的样式单等等，此时我们就希望不要产生这些多余的标签。      那么怎样才能让struts2不要生成这些标签呢？ 其实在struts-core-2.06.jar的包中包含了一些默认的模版文件，它们位于$ {struts-core-2.06.jar}/template下，其中有ajax，simple，xhtml等。          查看一下struts.properties,如果没有可以查看$ {struts-core-2.06.jar}/org/apache/struts2/default.properties文件，其中有如下配置： struts.ui.theme=xhtml struts.ui.templateDir=template struts.ui.templateSuffix=ftl     这一段就是关于struts2模版的配置信息，我们可以修改struts.properties文件，将其改成 struts.ui.theme=simple struts.ui.templateDir=template struts.ui.templateSuffix=ftl  如果没有struts.properties文件，可以修改struts.xml文件，在其中加入如下行  此时标签生成的html代码将会是

。