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

描述

创建一个选项转移列表组件, 由两个<select ...>标签以及其间的用于将选项在两个<select ...>之间相互移动的按钮. 表单提交时会自动选中全部选项.

注意: id和doubleId并不需要提供, 因为他们将由包含在form标签中的optiontransferselect标签自动生成. 生成的id和doubleId分别为<form_id>_<optiontransferselect_doubleName>和<form_id>_<optiontransferselect_doubleName>.

属性

名称	必填	缺省值	类型	描述
addAllToLeftLabel	false		Object/String	设置全部移动到左边的按钮的文字
addAllToRightLabel	false		Object/String	设置全部移动到右边的按钮的文字
addToLeftLabel	false		Object/String	设置向左移动的按钮的文字
addToRightLabel	false		Object/String	设置向右移动的按钮的文字
allowAddAllToLeft	false		Object/String	是否使用全部移动到左边的按钮
allowAddAllToRight	false		Object/String	是否使用全部移动到右边的按钮
allowAddToLeft	false		Object/String	是否使用移动到左边的按钮
allowAddToRight	false		Object/String	是否使用移动到右边的按钮
leftTitle	false		Object/String	设置左边列表框的标题
rightTitle	false		Object/String	设置右边列表框的标题
allowSelectAll	false		Object/String	是否使用全部选择按钮
selectAllLabel	false		Object/String	设置全部选择按钮的文字
buttonCssClass	false		Object/String	设置按钮使用的class
buttonCssStyle	false		Object/String	设置按钮使用的风格
doubleList	true		Object/String	创建第二个列表的可迭代数据源.
doubleListKey	false		Object/String	第二个列表使用的主键表达式
doubleListValue	false		Object/String	第二个列表使用的选项值表达式
doubleName	true		Object/String	整个组件的名称
doubleValue	false		Object/String	整个组件的值表达式
formName	false		Object/String	组件所在的form名称
doubleCssClass	false		Object/String	第二个列表的class
doubleCssStyle	false		Object/String	第二个列表的CSS风格
doubleHeaderKey	false		Object/String	第二个列表的题头主键值
doubleHeaderValue	false		Object/String	第二个列表的题头选项值
doubleEmptyOption	false		Object/String	第二个列表是否添加空选项
doubleDisabled	false		Object/String	第二个列表是否可以使用disable属性
doubleId	false		Object/String	第二个列表的id
doubleMultiple	false		Object/String	是否设置第二个列表的multiple属性
doubleOnblur	false		Object/String	设置第二个列表的onblur属性
doubleOnchange	false		Object/String	设置第二个列表的onchange属性
doubleOnclick	false		Object/String	设置第二个列表的onclick属性
doubleOndblclick	false		Object/String	设置第二个列表的ondbclick属性
doubleOnfocus	false		Object/String	设置第二个列表的onfocus属性
doubleOnkeydown	false		Object/String	设置第二个列表的onkeydown属性
doubleOnkeypress	false		Object/String	设置第二个列表的onkeyperss属性
doubleOnkeyup	false		Object/String	设置第二个列表的onkeyup属性
doubleOnmousedown	false		Object/String	设置第二个列表的onmousedown属性
doubleOnmousemove	false		Object/String	设置第二个列表的onmousemove属性
doubleOnmouseout	false		Object/String	设置第二个列表的onmouseout属性
doubleOnmouseover	false		Object/String	设置第二个列表的onmouseover属性
doubleOnmouseup	false		Object/String	设置第二个列表的onmouseup属性
doubleOnselect	false		Object/String	设置第二个列表的onselect属性
doubleSize	false		Object/String	设置第二个列表的size属性
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.

<-- minimum configuration -->
<ww:optiontransferselect 
  	label="Favourite Cartoons Characters"
	name="leftSideCartoonCharacters" 
	list="{'Popeye', 'He-Man', 'Spiderman'}" 
	doubleName="rightSideCartoonCharacters"
	doubleList="{'Superman', 'Mickey Mouse', 'Donald Duck'}" 
/>

 <-- possible configuration -->
 <ww:optiontransferselect 
  	label="Favourite Cartoons Characters"
	name="leftSideCartoonCharacters" 
	leftTitle="Left Title"
	rightTitle="Right Title"
	list="{'Popeye', 'He-Man', 'Spiderman'}" 
	multiple="true"
	headerKey="headerKey"
	headerValue="--- Please Select ---"
	emptyOption="true"
	doubleList="{'Superman', 'Mickey Mouse', 'Donald Duck'}" 
	doubleName="rightSideCartoonCharacters"
	doubleHeaderKey="doubleHeaderKey"
	doubleHeaderValue="--- Please Select ---" 
	doubleEmptyOption="true"
	doubleMultiple="true"
/>