本站不再更新,欢迎光临 java开发技术网
随笔-230  评论-230  文章-8  trackbacks-0
JavaScud | Forum | JIRA | Blog |
  Dashboard > WebWork2文档中文化计划 > Tags > Form Tags
  WebWork2文档中文化计划 Log In View a printable version of the current page.  
  Form Tags
Added by scud, last edited by yangkaifeng on May 21, 2006  (view change)
Labels: 
(None)

描述

对于表单标签,分为两种标签:form标签本身,和所有来包装单个的表单元素的其他标签.form标签本身的行为不同于它内部的元素,这是很重要的.在我们为所有表单标签,包括form标签在内,提供一个参考手册之前,我们必须先描述一些通用的属性.
请确认你已经读过了 Tag Syntax 文档 并且理解标签的属性语法是如何工作的.

表单标签 Themes

就像前面我们在Themes and Templates里面提到的,HTML标签(包括表单标签)都是模板驱动的.模板按照form的theme分组.WebWork缺省提供了三种theme:

  • simple
  • xhtml, 扩展了 simple (缺省theme)
  • ajax, 扩展了 xhtml

记住: xhtml theme 输出两列表格. 如果你需要不同的布局,我们强烈推荐你 不要 编写自己的HTML,而是创建自己的theme或者利用simple theme.

使用simple theme的缺点就是它不支持其他theme那么多的属性.例如.label属性在simple theme里没有任何用处.类似的,simple theme提供的功能也远远少于xhtml和ajax theme提供的:自动显示错误信息就不被支持.

通用属性

所有表单标签扩展了 UIBean 类.这个基类有一些通用属性,分为三种:模板相关的,javascript相关的和通用属性.我们不会在这里说明这些属性,而是维护每个标签的参考.然而,熟悉UI标签的结构以及那些属性对所有标签是可用的,也不失为一个好主意.

除了这些属性之外,对于所有表单元素标签存在一个特殊的属性: form(例如: ${parameters.form}). 这代表输出form标签的参数,并且允许你在你的表单元素和表单(form)本身之间进行交互.例如,在一个模板里,你可以通过 ${parameters.form.id} 访问form的ID.

模板相关属性

属性 Theme 数据类型 描述
templateDir n/a String 定义模板目录
theme n/a String 定义theme名称
template n/a String 定义模板名称

Javascript相关属性

属性 Theme 数据类型 描述
onclick simple String html javascript onclick 属性
ondbclick simple String html javascript ondbclick 属性
onmousedown simple String html javascript onmousedown 属性
onmouseup simple String html javascript onmouseup 属性
onmouseover simple String html javascript onmouseover 属性
onmouseout simple String html javascript onmouseout 属性
onfocus simple String html javascript onfocus 属性
onblur simple String html javascript onblur 属性
onkeypress simple String html javascript onkeypress 属性
onkeyup simple String html javascript onkeyup 属性
onkeydown simple String html javascript onkeydown 属性
onselect simple String html javascript onselect 属性
onchange simple String html javascript onchange 属性

Tooltip 相关属性

属性 数据类型 缺省值 描述
tooltip String none 设置此组件的tooltip
tooltipIcon String /webwork/static/tooltip/tooltip.gif tooltip图标的url
tooltipAboveMousePointer Boolean false 在鼠标光标位置上放置tooltip.另外设置 tooltipOffseY 允许你设置从鼠标光标位置的垂直位移.
tooltipBgColor String #e6ecff tooltip的背景色.
tooltipBgImg String none 背景图片.
tooltipBorderWidth String 1 tooltip边框的宽度.
tooltipBorderColor String #003399 tooltip边框的背景色
tooltipDelay String 500 显示Tooltip的时间延迟(毫秒). 类似基于操作系统的tooltip的行为.
tooltipFixCoordinateX String not specified 固定tooltip在指定的X坐标上.例如和tooltipSticky属性结合时很有用.
tooltipFixCoordinateY String not specified 固定tooltip在指定的Y坐标上.例如和tooltipSticky属性结合时很有用.
tooltipFontColor String #000066 字体颜色.
tooltipFontFace String arial,helvetica,sans-serif 字体,例如 verdana,geneva,sans-serif
tooltipFontSize String 11px 字体大小,例如 30px
tooltipFontWeight String normal Font weight. 可以是 normal 或者 bold
tooltipLeftOfMousePointer Boolean false 在鼠标光标位置左侧的Tooltip位置
tooltipOffsetX String 12 相对鼠标光标位置的水平位移.
tooltipOffsetY String 15 相对鼠标光标位置的垂直位移.
tooltipOpacity String 100 tooltip的透明度. 不透明度是行对透明度而言的.设置的值必须是一个介于0(完全透明)和100(不透明)之间的数字.Opera尚未支持.
tooltipPadding String 3 内部间隔,例如,边框和内容之间的空格,例如文字或者图片
tooltipShadowColor String #cccccc 使用指定的颜色创建阴影.
tooltipShadowWidth String 5 使用指定的宽度(距离)创建阴影.
tooltipStatic Boolean false 就像基于操作系统的tooltip, tooltip不随着鼠标光标移动而移动.
tooltipSticky Boolean false tooltip一直停留在它初始的位置,直到另外一个tooltip被激活,或者用户点击了文档.
tooltipStayAppearTime String 0 指定一个tooltip消失的时间间隔(毫秒),即时鼠标还在相关的HTML元素上不懂,设置<=0,就和没有定义一样.
tooltipTextAlign String left 调整包括标题和tooltip内容的文字位置.可以是right, left 或 justify
tooltipTitle String none 标题
tooltipTitleColor String #ffffff title文字的颜色
tooltipWidth String 300 tooltip的宽度

通用属性

属性 Theme 数据类型 描述
cssClass simple String 定义 html class 属性
cssStyle simple String 定义html style 属性
title simple String 定义html title 属性
disabled simple String 定义html disabled 属性
label xhtml String 定义表单元素的label
labelPosition xhtml String 定义表单元素的label位置(top/left),缺