JavaScud | Forum | JIRA | Blog |
  Dashboard > WebWork2文档中文化计划 > WebWork > Tags
  WebWork2文档中文化计划 Log In View a printable version of the current page.  
  Tags
Added by scud, last edited by kaktos on Apr 05, 2006  (view change)
Labels: 
(None)

webwork提供了一套不依赖于显示层技术的标签库。这一章我们将概括性的描述每一个标签, 比如此标签支持的属性,标签的行为等等。 大多数的标签都可以用于所有的模板语言(参考 JSP Tags, Velocity Tags,和 FreeMarker Tags),但是有一些只能用于特定的模板语言。 无论什么时候一个标签不能完全的支持每一个模板, 该标签会在参考文档中注明。

webwork中的标签分为两种类型: 通用标签和HTML标签。 除了功能和职责外这两种类型标签最大的区别是HTML标签支持模板(templates)和主题 (themes)。除了基本的参考外,我们将提供个个标签在所支持模板语言中的例子。

请确认你已经读过了 Tag Syntax 文档 并且理解标签的属性语法是如何工作的.

通用标签(General Tags)

通用标签用于在你的页面被渲染的时候控制流程。它们也可以用于从Action和Value Stack之外提取数据,比如Internationalization, JavaBeans,以及包含额外的url或者action执行结果。

  1. Control Tags 控制标签,负责流程控制,例如 if, else, and iterator.
  2. Data Tags 数据标签,数据创建和操作,例如 bean, push, and i18n.

HTML标签

同通用标签不同, HTML标签不过多提供控制结构或逻辑。而是着重于如何使用你 action/value stack或者Data Tags中的数据,并且在html的中呈现出来。所有的HTML标签都有受templates和theme驱动的唯一行为。 如果说普通标签只是简单的作些输出结果 (如果有内容)的话, HTML标签的输出则是因模板(template)而异, 他们常常组合在一个作为一个主题(theme),做实际的渲染输出html的工作。

独特的模板(template)支持功能可以帮助你用HTML标签构建一套丰富的可重用的并且符合你需求的UI组件。 请参考 Themes and Templates 指南了解更多此强大特性的信息。

  1. Themes and Templates:解释模板和主题在渲染html标签时如何工作(必读)。
  2. Form Tags 提供和表单相关的html输出,例如 form, textfield, 和 select.
  3. Non Form Tags 提供和表单无关的html输出, 例如 a, div, 和 tabbedPanel.

特定模板语言的标签支持

WebWork竭力支持你所偏爱的技术,这也是WebWork没有绑定于一种模板语言的原因。 webwork支持几乎所有应用广泛的模板语言甚至还为新语言提供了接口。默认情况下,几乎每一个标签都支持 JSP, Velocity, and FreeMarker。在这些章, 你会发现一些范例或者技术教你如何在你选用的模板语言中使用特定的标签。

从WebWork 2.2开始, FreeMarker已经成为webwork team推荐的"标准"模板语言. 这个选择有很多原因, 在不同的论坛中你可以找到, 但有一点相当重要: FreeMarker提供比Velocity更丰富的特性并且提供更好更准确的错误报告机制. JSP也可以用,但是对于一些需要更模块化的应用来说比较困难, 比如在运行期间改变模板或者做上传打包好的webwork的action和template文件模块。

  1. JSP Tags
  2. Velocity Tags
  3. FreeMarker Tags
Control Tags (WebWork2文档中文化计划)
Data Tags (WebWork2文档中文化计划)
Form Tags (WebWork2文档中文化计划)
FreeMarker Tags (WebWork2文档中文化计划)
JSP Tags (WebWork2文档中文化计划)
Non Form Tags (WebWork2文档中文化计划)
Tag Syntax (WebWork2文档中文化计划)
Themes and Templates (WebWork2文档中文化计划)
Velocity Tags (WebWork2文档中文化计划)
Site running on a free Atlassian Confluence Open Source Project License granted to WebWork China. Evaluate Confluence today.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.5.3 Build:#808 May 29, 2007) - Bug/feature request - Contact Administrators