描述
本标签使用一个text类型的INPUT和一个SELECT组合在一起提供组合框(Combo Box)的功能. 可以通过使用SELECT控件将文本输入到INPUT控件中, 或直接在文本框中输入文本.
本例中, SELECT使用id=year属性生成. Counter本身就是一个Iterator. 他将从first(值为text('firstBirthYear'))枚举到last(值为2000). SELECT是使用JavaScript生成的, 因此该标签应当包含在<form>标签中.
需要注意的是, 与<ww:select/>标签不同, 不能分别定义每个<option>标签的id(应该为value, 译注)属性或文本内容. 每一个属性都是直接使用列表元素的toString()方法生成的. 这大概是因为这里的下拉列表不关心实际提交的数据(指option的value属性, 译注), 而仅仅为了帮助用户填写文本框而已.
属性
| 名称 |
必填 |
缺省值 |
类型 |
描述 |
| list |
true |
|
Object/String |
生成列表项的可迭代数据源. 如果没有指定该属性, 将不显示下拉列表控件. |
| maxlength |
false |
|
Integer |
HTML maxlength属性 |
| maxLength |
false |
|
Object/String |
不建议使用. 建议使用maxlength属性替代. |
| readonly |
false |
false |
Boolean |
设置为只读,不允许输入 |
| size |
false |
|
Integer |
HTML size 属性 |
| 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属性 |
(snippet:id=tagattributes|javadoc=false|url=webwork/docs/tags/ComboBox.html)
示例
Content pulled from external source. Click here to refresh. |
JSP:
<ww:bean name="webwork.util.Counter" id="year">
<ww:param name="first" value="text('firstBirthYear')"/>
<ww:param name="last" value="2000"/>
<ww:combobox label="Birth year" size="6" maxlength="4" name="birthYear" list="#year"/>
</ww:bean>
Velocity:
#tag( ComboBox "label=Birth year" "size=6" "maxlength=4" "name=birthYear" "list=#year" )
|
