请确认你已经读过了 Tag Syntax 文档并且理解标签的属性语法是如何工作的.

描述

创建一个元素Select列表组件, 带有可以上下移动选项元素的按钮. 当表单提交时, 列表中的元素全部被选中并按照排列顺序(从顶至底)被提交.

属性

名称	必填	缺省值	类型	描述
allowMoveUp	false	true	Boolean	是否显示"上移"按钮
allowMoveDown	false	true	Boolean	是否显示"下移"按钮
allowSelectAll	false	true	Boolean	是否显示"全选"按钮
moveUpLabel	false	^	String	"上移"按钮的文本
moveDownLabel	false	v	String	"下移"按钮的文本
selectAllLabel	false	*	String	"全选"按钮的文本
emptyOption	false	false	Boolean	是否在题头选项后面添加一个空的(--)选项
headerKey	false		Object/String	设置列表的题头主键值. 一定不能为空值! "'-1'"或"''"是正确的取值, ""是错误的取值.
headerValue	false		Object/String	列表的题头选项值
multiple	false		Object/String	创建一个多选列表. 如果value属性指定了一个数组(正确的元素类型), 那么将预先选中数组中指定的多个选项.
size	false		Integer	该组件列表框的大小 (显示元素的个数)
list	true		Object/String	创建列表的可迭代数据源. 如果该列表是一个Map(key, value), 那么Map的主键将作为选项(<option>)的"value"属性, 而该主键对应的值作为选项的文本内容.
listKey	false		Object/String	列表数据源中元素对象的属性, 用于获取选项的值
listValue	false		Object/String	列表数据源中元素对象的属性, 用于获取选项的文本内容
theme	false		Object/String	输出元素时使用的主题(theme)(不使用缺省的)
template	false		Object/String	输出元素时使用的模板(template)(不使用缺省的)
cssClass	false		Object/String	输出元素时的class属性
cssStyle	false		Object/String	输出元素时的css样式定义(译者注:就是html元素的style属性)
title	false		Object/String	在输出元素时设置html属性title
disabled	false		Object/String	在输出元素时设置html属性disabled
label	false		Object/String	用于输出一个元素对应的label的表达式
labelPosition	false	left	Object/String	不赞成使用.
labelposition	false		Object/String	定义元素标签的位置(top/left)
requiredposition	false		Object/String	定义required属性输出的位置(left\|right)
name	false		Object/String	元素的名字
required	false	false	Boolean	如果设置为true, 在输出标签时将显示出此字段是必须输入的(译者注:如果使用默认模板,将会标示为"*")
tabindex	false		Object/String	在输出元素时设置html属性tabindex
value	false		Object/String	预设input元素的value属性.
onclick	false		Object/String	在输出元素时设置html属性onclick
ondblclick	false		Object/String	在输出元素时设置html属性ondblclick
onmousedown	false		Object/String	在输出元素时设置html属性onmousedown
onmouseup	false		Object/String	在输出元素时设置html属性onmouseup
onmouseover	false		Object/String	在输出元素时设置html属性onmouseover
onmousemove	false		Object/String	在输出元素时设置html属性onmousemove
onmouseout	false		Object/String	在输出元素时设置html属性onmouseout
onfocus	false		Object/String	在输出元素时设置html属性onfocus
onblur	false		Object/String	在输出元素时设置html属性onblur
onkeypress	false		Object/String	在输出元素时设置html属性onkeypress
onkeydown	false		Object/String	在输出元素时设置html属性onkeydown
onkeyup	false		Object/String	在输出元素时设置html属性onkeyup
onselect	false		Object/String	在输出元素时设置html属性onselect
onchange	false		Object/String	在输出元素时设置html属性onchange
tooltip	false		String	设置元素的tooltip属性(译者注:tooltip为工具栏提示)
tooltipConfig	false		String	设置tooltip属性的配置
id	false		Object/String	id是定位元素时使用的. 对于UI和表单标签它会被用作HTML的id属性

例子

Content pulled from external source. Click here to refresh.

<!-- Example 1: simple example -->
<ww:updownselect 
list="#{'england':'England', 'america':'America', 'germany':'Germany'}" 
name="prioritisedFavouriteCountries" 
headerKey="-1" 
headerValue="--- Please Order Them Accordingly ---" 
emptyOption="true" />

<!-- Example 2: more complex example -->
<ww:updownselect 
list="defaultFavouriteCartoonCharacters" 
name="prioritisedFavouriteCartoonCharacters" 
headerKey="-1" 
headerValue="--- Please Order ---" 
emptyOption="true" 
allowMoveUp="true" 
allowMoveDown="true" 
allowSelectAll="true" 
moveUpLabel="Move Up"
moveDownLabel="Move Down" 
selectAllLabel="Select All" />