5.17 updownselect标签

5.17  updownselect标签

updownselect标签的功能与checklist标签相似，它也允许你从一组选项里选中多个选项。updownselect标签将呈现为一个select元素，这个select元素的multiple属性被设置为multiple，并且还有用来同时选中所有选项的按钮，和用来对那些选项重新排序的按钮（如图5-13所示）。

表5-17列出了updownselect标签的属性。

表5-17  combobox标签的属性

名字	数据类型	默  认  值	说明
allowMoveDown	boolean	true	是否显示“下移”按钮
allowMoveUp	boolean	true	是否显示“上移”按钮
allowSelectAll	boolean	true	是否显示“全选”按钮
emptyOption	boolean	false	是否要在标题下面插入一个空白（--）选项
headerKey	String		选项列表里的第一项的键
headerValue	String		选项列表里的第一项的值
list*	String		用来充当选项来源的可遍历对象
listKey	String		用来提供选项值的对象属性
listValue	String		用来提供选项行标的对象属性

（续）

名字	数据类型	默  认  值	说明
moveDownLevel	String	v	“下移”按钮上的文本
moveUpLevel	String	^	“上移”按钮上的文本
multiple	boolean	false	是否允许用户进行“多选多”选择
selectAllLabel	String	*	“全选”按钮上的文本
size	Integer		需要显示的选项的个数

注意 如果包含着updownselect标签的表单未能通过输入验证，用户刚才在updownselect标签里选中的选项将不会保留下来。

下面的例子演示了如何利用updownselect标签来选择多种颜色。代码清单5-20给出了这个例子所使用的动作类（UpDownSelectTestAction），代码清单5-21给出了使用这个标签的JSP页面。

代码清单5-20  UpDownSelectTestAction类

代码清单5-21  UpDownSelect.jsp页面

如果你想测试一下这个动作，在你的浏览器里输入如下所示的URL即可：

http://localhost:8080/app05a/ UpDownSelect.action

呈现的元素如图5-13所示。

图5-13  使用updownselect标签

【责任编辑：云霞 TEL：[phone]】

回书目   上一节   下一节

原文：5.17 updownselect标签 返回读书频道首页