下拉框组件标签
下拉框标签的典型形式为: <form:select path="city" items="${cityList}"/>,它包括两方面的数据:1)对应表单对象属性值(city);2)用于构造整个下拉框选项的数据(cityList)。严格地说,下拉框组件分为单选和多选两种形式,当表单对象对应属性为复数形态的类型时(如String[]、List、Set),产生的目标组件为多选下拉框,反之为单选下拉框。
用于构造下拉框选项的数据也必须在referenceData()方法中准备好(可能从数据库字典表中加载或从外部配置文件中加载):
代码清单 4 UserRegisterController:为下拉框标签准备数据
package com.baobaotao.web.user; … public class UserRegisterController extends SimpleFormController { @Override protected Map referenceData(HttpServletRequest request) throws Exception { Map favoriteMap = new LinkedHashMap(); favoriteMap.put("1", "computer"); favoriteMap.put("2", "sport"); favoriteMap.put("3", "entertainment"); favoriteMap.put("4", "literature"); List cityList = new ArrayList();①为下拉框选项准备的数据 cityList.add("北京"); cityList.add("上海"); cityList.add("天津"); cityList.add("厦门"); return new ModelMap() .addObject("favoriteMap", favoriteMap) .addObject("cityList", cityList); } … } 这时,生成的下拉框HTML代码如下所示: <select id="city" name="city" > ① <option value="北京">北京</option> <option value="上海">上海</option> <option value="天津">天津</option> <option value="厦门">厦门</option> </select> <input type="hidden" name="_city" value="1"/> ②
首先,我们注意到②处有一个和复选框组件相似的配套隐藏组件,之所以会需要这个隐藏组件是出于和复选框相同的原因。下拉框的值和标签是相同的,都是cityList列表中的元素值。在实际应用中,我们一般为每一个选项提供一个代码,而非采用和标签相同的值,这样可以使用规范简短的代码保存数据,为后续的查询、引用带来方便。这时,可以采用下拉框标签的另一种属性设置方式:
<form:select path="city" items="${cityMap}" itemValue="key" itemLabel="value"/>
cityMap是一个已经通过referenceData()方法准备好的Map对象,itemValue对应下拉框的value属性,而itemValue="key"表示使用cityMap元素的键,itemLable对应下拉框的标签值, itemLabel="value"表示使用cityMap元素的值。实际上,items属性所绑定的也可以是一个List对象,其元素可以是一个JavaBean,这时可以通过itemValue和itemLabel指定引用JavaBean的属性。如下所示:
<form:select path="city" items="${cities}" itemValue="code" itemLabel="name"/>
cities对应一个通过referenceData()方法准备好的List对象,其元素为City对象,City对象包括code和name两个属性。通过以上这些方式,我们可以得到一个选项的值和标签不相同的下拉框:
<select id="city" name="city">
<option value="1">北京</option>
<option value="2">上海</option>
<option value="3">天津</option>
<option value="4" >厦门</option>
</select>
<input type="hidden" name="_city" value="1"/>
一般情况下,下拉框会提供一个类似于“请选择”或“--未选择--”的默认选项,这个选项本身不是有效的数据项,它们的存在仅仅为提示用户作选择或代表一个未作选择的空值。这时,我们可能会考虑手工提供一个下拉框选项,而其它的选项通过referenceData()提供的数据动态生成:
<form:select path="city">
<form:option value="" label="--请选择--"/> ①提示性的选项
<form:options items="${cityMap}" itemValue="key" itemLabel="value"/>②真实的选项数据
</form:select>
这样产生的下拉框在默认情况下将显示①处对应的选项,如果用户没有选择,选项相当于是一个空值。②处对应的<form:options>会将cityMap的数据转换为下拉框选项列表。