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

描述

创建一个HTML Select列表组件.

属性

名称	必填	缺省值	类型	描述
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属性

例子

注意: 对于那些使用list的标签(select可能是最常用的), 当使用OGNL的list定义表达式来创建list时(参见例子中的"months"), 
需要注意Map的主键(Key, months的例子中的'01', '02'等)是强类型的. '1'是一个字符(Char), '01'是一个字符串(String), 
"1"是一个字符串(String). 这很重要, 因为当"value"属性值与"list"属性中的主键类型不同(如: char和String的差别), 
即使他们的字符串值相等也不能匹配. 如果不能匹配, 列表中就不能包含选中项(auto-selected-entry)了.

Content pulled from external source. Click here to refresh.

<ww:select label="Pets"
       name="petIds"
       list="petDao.pets"
       listKey="id"
       listValue="name"
       multiple="true"
       size="3"
       required="true"
/>

<ww:select label="Months"
       name="months"
       headerKey="-1" headerValue="Select Month"
       list="#{'01':'Jan', '02':'Feb', [...]}"
       value="selectedMonth"
       required="true"
/>

// The month id (01, 02, ...) returned by the getSelectedMonth() call
// against the stack will be auto-selected