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. 属性

AttributeRequired?Runtime Expression?Description
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
idfalsetrueHTML 标准属性
namefalsetrueHTML 按钮标记的名称属性
valuefalsetrueHTML 按钮标记的名称属性

44.3 复选框标签

呈现类型为“复选框”的 HTML“Importing”标签。

表 44.2. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
labelfalsetrue要显示为标签一部分的值
langfalsetrueHTML 标准属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性
valuefalsetrueHTML 可选属性

44.4 复选框标签

呈现多个类型为“复选框”的 HTML“Importing”标签。

表 44.3. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
delimiterfalsetrue在类型为“复选框”的每个“Importing”标记之间使用的定界符。默认情况下没有定界符。
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
elementfalsetrue指定用于用类型“复选框”将每个“Importing”标签括起来的 HTML 元素。默认为“ span”。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
itemLabelfalsetrue值将显示为类型为“复选框”的“Importing”标签的一部分
itemstruetrue用于生成类型为“复选框”的“Importing”标签的对象的集合,Map 或数组
itemValuefalsetrueMap 到类型为“复选框”的“Importing”标签的“值”属性的属性名称
langfalsetrueHTML 标准属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.5 错误标记

在 HTML'span'标签中呈现字段错误。

表 44.4. 属性

AttributeRequired?Runtime Expression?Description
cssClassfalsetrue等效于“类”-HTML 可选属性
cssStylefalsetrue等效于“样式”-HTML 可选属性
delimiterfalsetrue用于显示多个错误消息的定界符。默认为 br 标签。
dirfalsetrueHTML 标准属性
elementfalsetrue指定用于呈现封闭错误的 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathfalsetrue错误对象的数据绑定路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.6 表单标签

呈现 HTML“ form”标签,并向内部标签公开绑定路径以进行绑定。

表 44.5. 属性

AttributeRequired?Runtime Expression?Description
acceptCharsetfalsetrue指定处理此表单的服务器接受的 Importing 数据的字符编码列表。该值是由空格和/或逗号分隔的字符集值列表。Client 端必须将此列表解释为“异或”列表,即服务器能够为每个收到的实体接受任何单个字符编码。
actionfalsetrueHTML 必需属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
enctypefalsetrueHTML 可选属性
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
methodfalsetrueHTML 可选属性
methodParamfalsetrue除 GET 和 POST 以外的 HTTP 方法使用的参数名称。默认值为“ _method”。
modelAttributefalsetrue公开表单对象的模型属性的名称。默认为'command'。
namefalsetrueHTML 标准属性-为向后兼容而添加
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
onresetfalsetrueHTML 事件属性
onsubmitfalsetrueHTML 事件属性
servletRelativeActionfalsetrue操作引用将附加到当前 servlet 路径
targetfalsetrueHTML 可选属性
titlefalsetrueHTML 标准属性

44.7 隐藏的标签

使用绑定值呈现类型为“隐藏”的 HTML“Importing”标签。

表 44.6. 属性

AttributeRequired?Runtime Expression?Description
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
pathtruetrue数据绑定属性的路径

44.8Importing 标签

使用绑定值呈现类型为“文本”的 HTML“Importing”标记。

表 44.7. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
altfalsetrueHTML 可选属性
autocompletefalsetrue通用可选属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
maxlengthfalsetrueHTML 可选属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
onselectfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
readonlyfalsetrueHTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。
sizefalsetrueHTML 可选属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.9 标签

在 HTML“标签”标签中呈现表单字段标签。

表 44.8. 属性

AttributeRequired?Runtime Expression?Description
cssClassfalsetrue等效于“类”-HTML 可选属性。
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。仅在出现错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
forfalsetrueHTML 标准属性
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue错误对象的数据绑定路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.10 选项标签

呈现单个 HTML“选项”。根据绑定值将“选定”设置为适当。

表 44.9. 属性

AttributeRequired?Runtime Expression?Description
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
labelfalsetrueHTML 可选属性
langfalsetrueHTML 标准属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性
valuetruetrueHTML 可选属性

44.11 选项标签

呈现 HTML“选项”标签的列表。根据绑定值将“选定”设置为适当。

表 44.10. 属性

AttributeRequired?Runtime Expression?Description
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
itemLabelfalsetrueMap 到“ option”标签内部文本的属性名称
itemstruetrue用于生成内部“ option”标签的对象的 Collection,Map 或数组
itemValuefalsetrueMap 到“选项”标签的“值”属性的属性名称
langfalsetrueHTML 标准属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.12 密码标签

使用绑定值呈现类型为“ password”的 HTML“ input”标记。

表 44.11. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
altfalsetrueHTML 可选属性
autocompletefalsetrue通用可选属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
maxlengthfalsetrueHTML 可选属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
onselectfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
readonlyfalsetrueHTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。
showPasswordfalsetrue是否显示密码值?默认为 false。
sizefalsetrueHTML 可选属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.13 单选按钮标签

呈现类型为“ radio”的 HTML“ input”标记。

表 44.12. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
labelfalsetrue要显示为标签一部分的值
langfalsetrueHTML 标准属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性
valuefalsetrueHTML 可选属性

44.14 单选按钮标签

呈现多个类型为“ radio”的 HTML“ input”标签。

表 44.13. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
delimiterfalsetrue在类型为“ radio”的每个“ input”标签之间使用的定界符。默认情况下没有定界符。
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
elementfalsetrue指定用于用类型“ radio”封装每个“ input”标签的 HTML 元素。默认为“ span”。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
itemLabelfalsetrue值将显示为类型为“ radio”的“ input”标签的一部分
itemstruetrue用于生成类型为“ radio”的“ input”标签的对象的 Collection,Map 或数组
itemValuefalsetrueMap 到类型为“ radio”的“ input”标签的“ value”属性的属性名称
langfalsetrueHTML 标准属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.15 选择标记

呈现 HTML“选择”元素。支持数据绑定到所选选项。

表 44.14. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
itemLabelfalsetrueMap 到“ option”标签内部文本的属性名称
itemsfalsetrue用于生成内部“ option”标签的对象的 Collection,Map 或数组
itemValuefalsetrueMap 到“选项”标签的“值”属性的属性名称
langfalsetrueHTML 标准属性
multiplefalsetrueHTML 可选属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
sizefalsetrueHTML 可选属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性

44.16 textarea 标签

呈现 HTML“文本区域”。

表 44.15. 属性

AttributeRequired?Runtime Expression?Description
accesskeyfalsetrueHTML 标准属性
colsfalsetrueHTML 必需属性
cssClassfalsetrue等效于“类”-HTML 可选属性
cssErrorClassfalsetrue等效于“类”-HTML 可选属性。当绑定字段有错误时使用。
cssStylefalsetrue等效于“样式”-HTML 可选属性
dirfalsetrueHTML 标准属性
disabledfalsetrueHTML 可选属性。将此属性的值设置为“ true”将禁用 HTML 元素。
htmlEscapefalsetrue启用/禁用呈现值的 HTML 转义。
idfalsetrueHTML 标准属性
langfalsetrueHTML 标准属性
onblurfalsetrueHTML 事件属性
onchangefalsetrueHTML 事件属性
onclickfalsetrueHTML 事件属性
ondblclickfalsetrueHTML 事件属性
onfocusfalsetrueHTML 事件属性
onkeydownfalsetrueHTML 事件属性
onkeypressfalsetrueHTML 事件属性
onkeyupfalsetrueHTML 事件属性
onmousedownfalsetrueHTML 事件属性
onmousemovefalsetrueHTML 事件属性
onmouseoutfalsetrueHTML 事件属性
onmouseoverfalsetrueHTML 事件属性
onmouseupfalsetrueHTML 事件属性
onselectfalsetrueHTML 事件属性
pathtruetrue数据绑定属性的路径
readonlyfalsetrueHTML 可选属性。将此属性的值设置为“ true”将使 HTML 元素变为只读。
rowsfalsetrueHTML 必需属性
tabindexfalsetrueHTML 标准属性
titlefalsetrueHTML 标准属性