19.2.10 select标签
select
标签渲染一个HTML
的select
元素。被渲染元素的选项可能来自赋予其items
属性的一个Collection
、Map
、Array
,或者来自一个嵌套的option
或者options
标签。select
标签的属性如表19.11所示。表19.11中的所有属性都是可选的,其中不包含HTML
属性。
表19.11select标签的属性
属性 |
描述 |
cssClass |
定义要应用到被渲染input 元素的CSS 类 |
cssStyle |
定义要应用到被渲染input 元素的CSS 样式 |
cssErrorClass |
定义要应用到被渲染input 元素的CSS 类,如果bound 属性中包含错误,则覆盖cssClass 属性值 |
htmlEscape |
接受true 或者false ,表示是否应该对被渲染的(多个)值进行HTML 转义 |
items |
用于生成input 元素的对象的Collection 、Map 或者Array |
itemLabelitem |
属性中定义的Collection 、Map 或者Array 中的对象属性,为每个input 元素提供label |
itemValueitem |
属性中定义的Collection 、Map 或者Array 中的对象属性,为每个input 元素提供值 |
path |
要绑定的属性路径 |
items 属性特别有用,因为它可以绑定到对象的Collection 、Map 、Array ,为select 元素生成选项。 |
|
例如,下面的select 标签绑定到form backing object 的category 属性的id 属性。它的选项来自model 属性categories 。每个选项的值均来自categoriescollection/map/array 的id 属性,它的Label 来自name 属性: |
|
1 2 3
| <form:select id="category" path="category.id" items="${categories}" itemLabel="name" itemValue="id"/>
|
19.2.11 option标签
option
标签渲染select
元素中用的一个HTML
的option
元素,其属性如表19.12所示。表19.12中的所有属性都是可选的,其中不包含HTML
属性。
表19.12option标签的属性
属性 |
描述 |
cssClass |
定义要应用到被渲染input 元素的CSS 类 |
cssStyle |
定义要应用到被渲染input 元素的CSS 样式 |
cssErrorClass |
定义要应用到被渲染input 元素的CSS 类,如果bound 属性中包含错误,则覆盖cssClass 属性值 |
htmlEscape |
接受true 或者false ,表示是否应该对被渲染的(多个)值进行HTML 转义 |
例如,下面是一个option 标签的范例: |
|
1 2 3 4 5
| <form:select id="category" path="category.id" items="${categories}" itemLabel="name" itemValue="id"> <option value="0">-- Please select --</option> </form:select>
|
这个代码片断是渲染一个select
元素,其选项来自model
属性categories
,以及option
标签。
19.2.12 options标签
options
标签生成一个HTML
的option
元素列表,其属性如表19.13所示,其中不包含HTML
属性。
表19.13options标签的属性
属性 |
描述 |
cssClass |
定义要应用到被渲染input 元素的CSS 类 |
cssStyle |
定义要应用到被渲染input 元素的CSS 样式 |
cssErrorClass |
定义要应用到被渲染input 元素的CSS 类,如果bound 属性中包含错误,则覆盖cssClass 属性值 |
htmlEscape |
接受true 或者false ,表示是否应该对被渲染的(多个)值进行HTML 转义 |
items |
用于生成input 元素的对象的Collection 、Map 或者Array |
itemLabelitem |
属性中定义的Collection 、Map 或者Array 中的对象属性,为每个input 元素提供label |
itemValueitem |
属性中定义的Collection 、Map 或者Array 中的对象属性,为每个input 元素提供值 |
app19a 应用程序展示了一个options 标签的范例。 |
|
19.2.13 errors标签
errors
标签渲染一个或者多个HTML
的span
元素,每个span
元素中都包含一个字段错误。这个标签可以用于显示一个特定的字段错误,或者所有字段错误。
errors
标签的属性如表19.14所示。表19.14中的所有属性都是可选的,其中不包含可能在HTML
的span
元素中出现的HTML
属性。
表19.14errors标签的属性
属性 |
描述 |
cssClass |
定义要应用到被渲染input 元素的CSS 类 |
cssStyle |
定义要应用到被渲染input 元素的CSS 样式 |
delimiter |
分隔多个错误消息的分隔符 |
element |
定义一个包含错误消息的HTML 元素 |
htmlEscape |
接受true 或者false ,表示是否应该对被渲染的(多个)值进行HTML 转义 |
path |
要绑定的错误对象路径 |
例如,下面这个errors 标签显示了所有字段错误: |
|
下面的errors
标签显示了一个与form backing object
的author
属性相关的字段错误:
1
| <form:errors path="author"/>
|