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 标准属性
上一章 首页