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类的基本属性:
- key : 被请求标签的标签键.如果在message resource中该键没有相对应的值, 则该键被显示.
- arg0,arg1,arg2,arg3,arg4: 可选的参数替代值
- name: 在pageContext,request,session或者application范围的我们希望编辑其属性的bean名字.默认为struts form bean.
- property: 需要查看或者编辑的bean的属性
- isRequired: 当设置为true的时候,输入域后面用红色星号标志,如果value值为null的话.默认为false.
- styleClass: 使用的CSS
- mode: field显示模式.模式必须匹配式样 , , ,一个field模式的只应为E(可编辑), I(可视查+隐藏,例如只读), N(不显示), H(隐藏), P(如果存在则视察), S(展示,对非隐藏的视察), R(只读), D(失能)
- model: 使用显示模型,参见skin page.
- policy: 显示规则
- hint: label的提示键
- tooltip: field的提示键
- layout: 如果设置为false,则不生成layout代码(例如只生成标签).这可以只使用struts-layout的"显示模式"框架.
- 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. - onchange: Javacript的onchange事件柄
- value: field的初始值,默认值为对应的Struts ActionForm的属性.
绘制field,显示一个text, password, textarea或者checkbox. 该标签已经deprecated.
| 属性名称 | 描述 |
| arg0, arg1, arg2, arg3, arg4, key, locale, name, property, styleClass, cols, max length, rows, size | 和
|
| access | 设置该field可读写还是只读.可选 READWRITE | READONLY, 默认为: READWRITE |
| isRequired | 设置该field是否为必选项,默认为false |
| type | field的类型,可选 PASSWORD | TEXT | TEXTAREA | NUMBER | BOOLEAN | DATE. 默认为 TEXT |
产生一个输入文本域
| 属性名称 | 描述 |
| type | 在视察模式下,使用特定的struts-layout formatter去格式化值 |
| editType | 在编辑模式下,使用特定的struts-layout formatter去格式化值 |
产生一个多行输入文本域, 没有特别的参数
产生一个选择框, 没有特别的参数
产生一个密码输入域
| 属性名称 | 描述 |
| redisplay | 如果设置为true的话,重新显示密码,注意在生成的HTML代码中密码是可读的 |
生成一个文件上传和下载的域
| 属性名称 | 描述 |
| fileKey | 显示文件名文本的键 |
| fileName | form bean中给定下载文件名的属性,如果没有设置则使用fileKey |
| filePath | form bean中给定下载文件URL的属性 |
生成一个日期输入域, 这个标签是一个文本输入域,显示一个弹出的日历
| 属性名称 | 描述 |
| calendarTooltip | 可改变的日历描述值,默认的是" pick up a date" |
| startYear | 如果设置的话, 日历的开始年份 |
| endYear | 如果设置的话, 日历的结束年份 |
| patternKey | 模式键, 选择日期模式的键 |
生成一个选择框, 和<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句柄 |
生成一个单选框, 和<html:radio>的主要区别在于:
1. 生成一个标签
2. 支持struts-layout的isRequired, layout, policy和mode 等特殊的属性
生成一个单选框列表, 和select标签一样,但是显示的是单选按钮,而不是选择框. 需要在<layout:option>和<layout:options>内
| arg0, arg1, arg2, arg3, arg4, key, locale, name, styleClass, property, value | 和<html:radio>,<bean:message>一样 |
生成一个选择框列表,需要在<layout:option>和<layout:options>内, 对应的form属性必须是String indexed属性
| cols | checkbox列数 |
< layout:option > < layout:options >
< layout:optionsCollection >
< layout:optionsDependent >
< layout:detail >
< layout:suggest >