struts2.0标签技术简介
2009-08-29 21:35
411 查看
Converter表单标签的theme
HTML标签(包括表单标签)都是模板驱动的.模板按照form的theme分组.struts2缺省提供了三种theme:
simple
xhtml, 扩展了 simple (缺省theme)
css_html
ajax, 扩展了 xhtml
使用simple theme的缺点就是它不支持其他theme那么多的属性.例如.label属性在simple theme里没有任何用处.类似的,simple theme提供的功能也远远少于xhtml和ajax theme提供的:自动显示错误信息就不被支持.
通用的属性
所有表单标签扩展了 UIBean 类.这个基类有一些通用属性,分为三种:模板相关的,javascript相关的和通用属性.
value/name的关系
在很多标签里,除了form标签,在 name 和 value 属性之间存在一个独特的关系. name 属性用于得到表单元素的名字以及提交时用到.实际上它也是你希望绑定值的表达式.在大多数情况下,它是一个简单的JavaBean属性,例如 "firstName".这会最终调用setFirstName.
类似的,你经常也希望在你的表单元素里显示相同的JavaBean属性的已经存在的数据.现在, value 属性派上了用场. 一个 "%{firstName}"会调用getFirstName来在你的表单里显示它,允许用户编辑这个值并重新提交它.
<s:textfield label="First name" name="firstName" value="%{firstName}"/>
然而,因为 name 和 value 的关系经常是可预知的,我们会自动为你处理这些,这样做就可以:
<s:textfield label="First name" name="firstName"/>
<s:textfield label="用户名" name="userName" value="abasen" tooltip="Enter your Name here"/>
对于form,ID被设定为action的名字.在前一个例子中,ID会设置为"updatePerson".
对于表单元素,ID为设定为 [form's ID]_[element name]
HTML标签(包括表单标签)都是模板驱动的.模板按照form的theme分组.struts2缺省提供了三种theme:
simple
xhtml, 扩展了 simple (缺省theme)
css_html
ajax, 扩展了 xhtml
使用simple theme的缺点就是它不支持其他theme那么多的属性.例如.label属性在simple theme里没有任何用处.类似的,simple theme提供的功能也远远少于xhtml和ajax theme提供的:自动显示错误信息就不被支持.
通用的属性
所有表单标签扩展了 UIBean 类.这个基类有一些通用属性,分为三种:模板相关的,javascript相关的和通用属性.
模板相关属性
属性 | 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),缺省为left |
requiredposition | xhtml | String | 定义required 标识相对label元素的位置 (left/right),缺省是 right |
name | simple | String | 表单元素的name映射 |
required | xhtml | Boolean | 在label中添加 * (true增加,否则不增加) |
tabIndex | simple | String | 定义html tabindex 属性 |
value | simple | Object | 定义表单元素的value |
在很多标签里,除了form标签,在 name 和 value 属性之间存在一个独特的关系. name 属性用于得到表单元素的名字以及提交时用到.实际上它也是你希望绑定值的表达式.在大多数情况下,它是一个简单的JavaBean属性,例如 "firstName".这会最终调用setFirstName.
类似的,你经常也希望在你的表单元素里显示相同的JavaBean属性的已经存在的数据.现在, value 属性派上了用场. 一个 "%{firstName}"会调用getFirstName来在你的表单里显示它,允许用户编辑这个值并重新提交它.
<s:textfield label="First name" name="firstName" value="%{firstName}"/>
然而,因为 name 和 value 的关系经常是可预知的,我们会自动为你处理这些,这样做就可以:
<s:textfield label="First name" name="firstName"/>
<s:textfield label="用户名" name="userName" value="abasen" tooltip="Enter your Name here"/>
ID Name 设置
所有的表单标签自动为你设置一个 ID. 你可以自由地按照你希望的那样覆盖这个值. ID的设置是这样工作的:对于form,ID被设定为action的名字.在前一个例子中,ID会设置为"updatePerson".
对于表单元素,ID为设定为 [form's ID]_[element name]
相关文章推荐
- struts 2.0标签库简介
- struts2.0标签简介
- struts2.0的标签库(简介)
- struts2.0 标签 简介
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- 引用 struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- Struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- struts2.0的标签库(简介)
- Struts2.0标签使用之action
- Struts2.0深入学习 Strust2与Servlet API,Action多方法调用,result标签的type的类型
- struts技术的logic标签
- Struts-2.0标签,关于ajax标签那些事儿.....
- struts2.0和struts1.2的区别的第一次小体会(struts标签)