Struts-Layout标签:Input类

Struts-Layout标签:Input类

Struts-Layout的Input类型标签和Struts-html标签库差不多,并且支持几乎所有的Struts-html标签库支持的属性. Struts-Layout Input类型标签和它的主要区别在于:

1. layout标签绘制一个标签label

2. 标签可以被设置为不可编辑的

3. 标签可以显示和他们属性相关的错误

4.标签可以被设置为必须的,并且使用*号标志该标签为必须栏用以提醒用户输入

同时可以使用FormUtils.setFieldDisplayMode(request, form, fieldName, mode)来设置显示模式. 在field标签中的HTML代码将在input标签之后绘制.这样能够实现增加一个按钮,允许从一弹出页的input field中选取值.

Input类的基本属性:

1. key :  被请求标签的标签键.如果在message resource中该键没有相对应的值, 则该键被显示.
2. arg0,arg1,arg2,arg3,arg4:  可选的参数替代值
3. name:  在pageContext,request,session或者application范围的我们希望编辑其属性的bean名字.默认为struts form bean.
4. property: 需要查看或者编辑的bean的属性
5. isRequired: 当设置为true的时候,输入域后面用红色星号标志,如果value值为null的话.默认为false.
6. styleClass: 使用的CSS
7. mode: field显示模式.模式必须匹配式样<create></create>,<edit></edit>,<inspect></inspect>,一个field模式的只应为E(可编辑), I(可视查+隐藏,例如只读), N(不显示), H(隐藏), P(如果存在则视察), S(展示,对非隐藏的视察), R(只读), D(失能)
8. model: 使用显示模型,参见skin page.
9. policy:  显示规则
10. hint:  label的提示键
11. tooltip: field的提示键
12. layout:  如果设置为false,则不生成layout代码(例如只生成标签).这可以只使用struts-layout的"显示模式"框架.
13. layoutId:  DHTML标签的id. 这允许显示或者隐藏具有下列代码的标签: <!----> document.getElementById(layoutId + "F").style = "none" to hide (or "" to show);
    document.getElementById(layoutId + "L").style = "none" to hide (or "" to show); layoutId + "F" is the input field cell, layoutId + "L" is the label cell.
14. onchange: Javacript的onchange事件柄
15. value:  field的初始值,默认值为对应的Struts ActionForm的属性.

 

• <!---->< layout:field >

绘制field,显示一个text, password, textarea或者checkbox. 该标签已经deprecated.

属性名称	描述
<!----> arg0, arg1, arg2, arg3, arg4, key, locale, name, property, styleClass, cols, max length, rows, size	和,<message></message>一样
access	设置该field可读写还是只读.可选<!----> READWRITE | READONLY, 默认为: READWRITE
isRequired	设置该field是否为必选项,默认为false
type	field的类型,可选<!----> PASSWORD | TEXT | TEXTAREA | NUMBER | BOOLEAN | DATE. 默认为 TEXT

• < layout:text >

产生一个输入文本域

属性名称	描述
type	在视察模式下,使用特定的struts-layout formatter去格式化值
editType	在编辑模式下,使用特定的struts-layout formatter去格式化值

• < layout:textarea >

产生一个多行输入文本域, 没有特别的参数 

• < layout:checkbox >

 产生一个选择框, 没有特别的参数

•  < layout:password >

产生一个密码输入域

属性名称	描述
redisplay	如果设置为true的话,重新显示密码,注意在生成的HTML代码中密码是可读的

• < layout:file >

生成一个文件上传和下载的域

属性名称	描述
fileKey	显示文件名文本的键
fileName	form bean中给定下载文件名的属性,如果没有设置则使用fileKey
filePath	form bean中给定下载文件URL的属性

 < layout:date >

生成一个日期输入域, 这个标签是一个文本输入域,显示一个弹出的日历

属性名称	描述
calendarTooltip	可改变的日历描述值,默认的是" pick up a date"
startYear	如果设置的话, 日历的开始年份
endYear	如果设置的话, 日历的结束年份
patternKey	模式键, 选择日期模式的键

< layout:select >

生成一个选择框, 和<html:select>主要的区别在于:

1. 生成一个标签

2. 支持struts-layout的isRequired, layout, policy和mode 等特殊的属性

属性名称	描述
<!----> arg0, arg1, arg2, arg3, arg4, key, locale, name, styleClass,property, multiple, size, value	和<html:select>, <bean:message> 标签一样
filter	将敏感的html字符过滤,和来自所有的option标签的数据一起工作
onchange	onchange javascript句柄

< layout:radio >

生成一个单选框, 和<html:radio>的主要区别在于:

1. 生成一个标签

2. 支持struts-layout的isRequired, layout, policy和mode 等特殊的属性

< layout:radios >

生成一个单选框列表, 和select标签一样,但是显示的是单选按钮,而不是选择框. 需要在<layout:option>和<layout:options>内

<!----> arg0, arg1, arg2, arg3, arg4, key, locale, name, styleClass, property, value	和<html:radio>,<bean:message>一样

< layout:checkboxes >

生成一个选择框列表,需要在<layout:option>和<layout:options>内, 对应的form属性必须是String indexed属性

cols	checkbox列数

< layout:option > < layout:options >

< layout:optionsCollection >
< layout:optionsDependent >
< layout:detail >
< layout:suggest >