On this page
44. Spring 形式的 JSP 标签库
44.1 Introduction
可以与 Spring 框架一起使用的视图技术之一是 Java Server Pages(JSP)。为了帮助您使用 Java Server Pages 实现视图,Spring 框架为您提供了一些用于评估错误,设置主题和输出国际化消息的标签。
请注意,此表单标签库生成的各种标签均符合XHTML-1.0-Strict specification和服务员DTD的要求。
本附录描述spring-form.tld
标签库。
44.2 按钮标签
在 HTML“按钮”标签中呈现表单字段标签。
表 44.1. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
id | false | true | HTML 标准属性 |
name | false | true | HTML 按钮标记的名称属性 |
value | false | true | HTML 按钮标记的名称属性 |
44.3 复选框标签
呈现类型为“复选框”的 HTML“Importing”标签。
表 44.2. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
label | false | true | 要显示为标签一部分的值 |
lang | false | true | HTML 标准属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
value | false | true | HTML 可选属性 |
44.4 复选框标签
呈现多个类型为“复选框”的 HTML“Importing”标签。
表 44.3. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
delimiter | false | true | 在类型为“复选框”的每个“Importing”标记之间使用的定界符。默认情况下没有定界符。 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
element | false | true | 指定用于用类型“复选框”将每个“Importing”标签括起来的 HTML 元素。默认为“ span”。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
itemLabel | false | true | 值将显示为类型为“复选框”的“Importing”标签的一部分 |
items | true | true | 用于生成类型为“复选框”的“Importing”标签的对象的集合,Map 或数组 |
itemValue | false | true | Map 到类型为“复选框”的“Importing”标签的“值”属性的属性名称 |
lang | false | true | HTML 标准属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.5 错误标记
在 HTML'span'标签中呈现字段错误。
表 44.4. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
delimiter | false | true | 用于显示多个错误消息的定界符。默认为 br 标签。 |
dir | false | true | HTML 标准属性 |
element | false | true | 指定用于呈现封闭错误的 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | false | true | 错误对象的数据绑定路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.6 表单标签
呈现 HTML“ form”标签,并向内部标签公开绑定路径以进行绑定。
表 44.5. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
acceptCharset | false | true | 指定处理此表单的服务器接受的 Importing 数据的字符编码列表。该值是由空格和/或逗号分隔的字符集值列表。Client 端必须将此列表解释为“异或”列表,即服务器能够为每个收到的实体接受任何单个字符编码。 |
action | false | true | HTML 必需属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
enctype | false | true | HTML 可选属性 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
method | false | true | HTML 可选属性 |
methodParam | false | true | 除 GET 和 POST 以外的 HTTP 方法使用的参数名称。默认值为“ _method”。 |
modelAttribute | false | true | 公开表单对象的模型属性的名称。默认为'command'。 |
name | false | true | HTML 标准属性-为向后兼容而添加 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
onreset | false | true | HTML 事件属性 |
onsubmit | false | true | HTML 事件属性 |
servletRelativeAction | false | true | 操作引用将附加到当前 servlet 路径 |
target | false | true | HTML 可选属性 |
title | false | true | HTML 标准属性 |
44.7 隐藏的标签
使用绑定值呈现类型为“隐藏”的 HTML“Importing”标签。
表 44.6. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
path | true | true | 数据绑定属性的路径 |
44.8Importing 标签
使用绑定值呈现类型为“文本”的 HTML“Importing”标记。
表 44.7. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
alt | false | true | HTML 可选属性 |
autocomplete | false | true | 通用可选属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
maxlength | false | true | HTML 可选属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
onselect | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
readonly | false | true | HTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。 |
size | false | true | HTML 可选属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.9 标签
在 HTML“标签”标签中呈现表单字段标签。
表 44.8. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
cssClass | false | true | 等效于“类”-HTML 可选属性。 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。仅在出现错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
for | false | true | HTML 标准属性 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 错误对象的数据绑定路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.10 选项标签
呈现单个 HTML“选项”。根据绑定值将“选定”设置为适当。
表 44.9. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
label | false | true | HTML 可选属性 |
lang | false | true | HTML 标准属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
value | true | true | HTML 可选属性 |
44.11 选项标签
呈现 HTML“选项”标签的列表。根据绑定值将“选定”设置为适当。
表 44.10. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
itemLabel | false | true | Map 到“ option”标签内部文本的属性名称 |
items | true | true | 用于生成内部“ option”标签的对象的 Collection,Map 或数组 |
itemValue | false | true | Map 到“选项”标签的“值”属性的属性名称 |
lang | false | true | HTML 标准属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.12 密码标签
使用绑定值呈现类型为“ password”的 HTML“ input”标记。
表 44.11. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
alt | false | true | HTML 可选属性 |
autocomplete | false | true | 通用可选属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
maxlength | false | true | HTML 可选属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
onselect | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
readonly | false | true | HTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。 |
showPassword | false | true | 是否显示密码值?默认为 false。 |
size | false | true | HTML 可选属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.13 单选按钮标签
呈现类型为“ radio”的 HTML“ input”标记。
表 44.12. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
label | false | true | 要显示为标签一部分的值 |
lang | false | true | HTML 标准属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
value | false | true | HTML 可选属性 |
44.14 单选按钮标签
呈现多个类型为“ radio”的 HTML“ input”标签。
表 44.13. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
delimiter | false | true | 在类型为“ radio”的每个“ input”标签之间使用的定界符。默认情况下没有定界符。 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
element | false | true | 指定用于用类型“ radio”封装每个“ input”标签的 HTML 元素。默认为“ span”。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
itemLabel | false | true | 值将显示为类型为“ radio”的“ input”标签的一部分 |
items | true | true | 用于生成类型为“ radio”的“ input”标签的对象的 Collection,Map 或数组 |
itemValue | false | true | Map 到类型为“ radio”的“ input”标签的“ value”属性的属性名称 |
lang | false | true | HTML 标准属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.15 选择标记
呈现 HTML“选择”元素。支持数据绑定到所选选项。
表 44.14. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
itemLabel | false | true | Map 到“ option”标签内部文本的属性名称 |
items | false | true | 用于生成内部“ option”标签的对象的 Collection,Map 或数组 |
itemValue | false | true | Map 到“选项”标签的“值”属性的属性名称 |
lang | false | true | HTML 标准属性 |
multiple | false | true | HTML 可选属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
size | false | true | HTML 可选属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |
44.16 textarea 标签
呈现 HTML“文本区域”。
表 44.15. 属性
Attribute | Required? | Runtime Expression? | Description |
---|---|---|---|
accesskey | false | true | HTML 标准属性 |
cols | false | true | HTML 必需属性 |
cssClass | false | true | 等效于“类”-HTML 可选属性 |
cssErrorClass | false | true | 等效于“类”-HTML 可选属性。当绑定字段有错误时使用。 |
cssStyle | false | true | 等效于“样式”-HTML 可选属性 |
dir | false | true | HTML 标准属性 |
disabled | false | true | HTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。 |
htmlEscape | false | true | 启用/禁用呈现值的 HTML 转义。 |
id | false | true | HTML 标准属性 |
lang | false | true | HTML 标准属性 |
onblur | false | true | HTML 事件属性 |
onchange | false | true | HTML 事件属性 |
onclick | false | true | HTML 事件属性 |
ondblclick | false | true | HTML 事件属性 |
onfocus | false | true | HTML 事件属性 |
onkeydown | false | true | HTML 事件属性 |
onkeypress | false | true | HTML 事件属性 |
onkeyup | false | true | HTML 事件属性 |
onmousedown | false | true | HTML 事件属性 |
onmousemove | false | true | HTML 事件属性 |
onmouseout | false | true | HTML 事件属性 |
onmouseover | false | true | HTML 事件属性 |
onmouseup | false | true | HTML 事件属性 |
onselect | false | true | HTML 事件属性 |
path | true | true | 数据绑定属性的路径 |
readonly | false | true | HTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。 |
rows | false | true | HTML 必需属性 |
tabindex | false | true | HTML 标准属性 |
title | false | true | HTML 标准属性 |