Struts HTML 标记的属性

本文档描述在 Struts HTML 标记库中定义的元素的属性。缺省情况下,这些元素中每个元素的名称都有 html: 前缀。

每个 Struts 元素都有一定数目的属性,可使用元素的“属性”视图来设置这些属性。在使用元素的“属性”视图时,使用此“属性”的表来查找想要了解其更多详细信息的属性。某些属性具有相同名称,但在不同元素中有不同的用法。属性是按字母顺序列示的。

属性 所属元素 描述
accept file 指定以逗号分隔的内容类型列表,提交至的服务器知道如何处理这些内容类型。客户机浏览器可使用该列表来限制可供选择的文件选项集合。缺省情况下,不发送内容类型列表。
accesskey button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、submit、text 和 textarea 指定用来将焦点立即移至此元素的键盘字符。
action form、frame 和 link 指定包含此传送目标的实际内容相对 URI 的全局操作逻辑名。必须指定下列其中一项属性:actionforwardhrefpage。可以通过添加 paramIdname 属性来动态修改此超链接。[对于 form 是必需的]
align image 指定此图像的对齐方式。
建议不使用: 在 HTML 4 中建议了不要使用此属性,而建议使用 CSS。有关更多详细信息,请参阅 www.w3.org/TR/REC-html40/struct/objects.html#h-13.7.4。
align img 指定下列表示图像对齐方式的其中一个值:
left
左对齐,文本位于右边
right
右对齐,文本位于左边
top
使图像与文本顶部对齐于同一行
middle
使图像的垂直中心与文本基线对齐
bottom
使图像与文本基线底部对齐
texttop
使图像顶部与文本字体顶部对齐于同一行
absmiddle
使图像的垂直中心与文本的绝对中心对齐
absbottom
使图像与文本字体的绝对底部对齐于同一行
alt button、cancel、checkbox、file、hidden、image、img、multibox、password、radio、reset、select、submit、text 和 textarea 指定组件的备用文本。此备用文本在元素不能正常呈示(例如,浏览器不支持表单或设置为不显示图像)时充当内容。
altKey button、cancel、checkbox、file、hidden、image、img、multibox、password、radio、reset、select、submit、text 和 textarea 指定此元素的备用文本的消息资源键。
anchor frame、link、include 和 rewrite 指定要添加至生成的超链接的可选锚点标记。不要在属性值中指定编号符号(#)。
border image 和 img 指定此图像周围的边框的宽度(以像素计)。
bundle errors、image、img、messages 和 option 指定 servlet 上下文属性键供 MessageResources 实例使用。它缺省为对操作 servlet 配置的应用程序资源。
cdata javascript 如果设置为 true 且启用了 XHTML,则将 JavaScript™ 代码打包成一个 CDATA 段以防止 XML 解析。缺省值为 true,以便与 W3C 的建议相符。
collection options 指定 JSP bean 的名称(在某一范围内),该 JSP bean 是其它一些 bean 的集合,每个这样的 bean 都具有由用来检索每个选项的值和标注的 property 属性和 labelProperty 属性命名的属性。
cols textarea 指定要显示的列数。
disabled button、cancel、checkbox、file、image、option、multibox、password、radio、reset、select、submit、text 和 textarea 如果设置为 true,则禁用输入字段。
dynamicJavascript javascript 如果设置为 false,则不呈示动态 JavaScript 代码。缺省值为 true
enctype form 指定要用来提交此表单的内容编码(如果方法为 POST)。如果您要使用文件标记来启用文件上载,则必须将此属性设置为 multipart/form-data。如果省略此属性,则将使用浏览器缺省值(通常是 application/x-www-form-urlencoded)。
filter options 和 optionsCollection 如果设置为 false,则不过滤 HTML 中敏感字符的选项标注。缺省情况下,这样的值被转换为其实体等价值。
focus form (在此表单的各字段中)指定字段名,将使用 JavaScript 函数将初始焦点指定给该字段。如果省略此属性,则将不呈示针对此目的的特殊 JavaScript 代码。
focusIndex form 如果 focus 字段是一个字段数组(如单选按钮组),则指定数组中要接收焦点的下标。
footer messages 指定将在消息迭代完成后打印的可选消息资源键。
formName javascript 指定用于检索特定验证规则集的键(表单名)。
forward frame、include 和 rewrite 指定包含此传送目标的实际内容相对 URI 的全局 ActionForward 的逻辑名。必须指定下列其中一项属性:actionforwardhrefpage。可以通过添加 paramIdname 属性来动态修改此超链接。
frameborder frame 如果设置为 1,则在此框架四周生成框架边框。缺省值为 0
frameName frame 对呈示的 frame 元素的 name 属性指定值。
header messages 指定将在消息迭代开始之前打印的可选消息资源键。
height img 指定显示的图像的高度。指定此属性以及 width 属性有助于加快浏览器呈示页的速度。
href frame、link、include 和 rewrite 指定此超链接被激活时将控制转移至的 URL。必须指定下列其中一项属性:actionforwardhrefpage。可以通过添加 paramIdname 属性来动态修改此超链接。
hspace img 指定图像与文本之间的水平间隔。文本与图像可在同一段,也可以环绕在图像周围。
htmlComment javascript 指定是否要将 JavaScript 代码与 HTML 注释封装在一起。此属性在 XHTML 方式中被忽略,因为脚本会被 XML 解析器删除。有关向 XML 解析器隐藏脚本的详细信息,请参阅 cdata 属性。缺省值为 true
id messages 指定页范围 JSP bean 的必需名称,如果消息集合不为空,则每次迭代时该 JSP bean 将包含该消息集合的当前元素。[必填]
idName radio 指定将返回 radio 标记值的 bean(在某一范围内)的名称。当 idName 属性(通常由迭代器显示)存在时,value 属性被用作将返回此迭代的 radio 标记值的 idName bean 上的属性名称。
imageName img 指定一个要在此页内定义的名称,以便可从该页内的脚本引用它。此处指定的值将是生成的 img 元素中 name 属性的值。
indexed button、checkbox、file、hidden、image、password、radio、select、submit、text 和 textarea 仅在 logic:iterate 标记内有效。如果为 true,则将 html 标记的名称呈示为 propertyName[int],其中 int 将在每一迭代过程中生成并取自祖先 logic:iterate 标记。
indexed link 仅在 logic:iterate 标记内有效。如果为 true,则将 indexed 参数与来自 indexId 属性的名称添加至查询字符串。indexed 参数看起来像 index[int],其中的 int 将在每一迭代过程中生成并取自祖先 logic:iterate 标记。
indexId link 指定 indexed 参数的另一名称。有关更多信息,请参阅 indexed 属性。
ismap img 指定此图像所属于的服务器端映射的名称。
key option 如果指定了此项,将对向此选项的用户显示的文本定义消息键,在 bundle 指定的资源束中查找该消息键。缺省情况为从此标记的主体内容获取要显示的文本。
label optionsCollection 指定(表示要为每个选项呈示的标注的)集合中的 bean 的属性。缺省值为 label
labelName options 为这些选项指定包含要向用户显示的标注集合的 JSP bean(在某一范围内)的名称。
labelProperty options 为这些选项指定表单 bean 或由 labelName 属性指定的 bean(它将返回要向用户显示的标注集合)的属性。
linkName link 指定要在此页内定义的锚点名称,以便此页内的超链接可引用它。此处指定的值将是生成的 anchor 标记中 name 属性的值。
locale errors、image、img、messages 和 option 指定用来查找国际化消息的请求或会话 locale 属性的值。
locale html 如果设置为 true 且当前尚未设置任何语言环境,则会根据当前请求的“接受语言”头(如果有的话)在会话中存储语言环境。如果尚未存在会话,此属性将创建一个会话。会对 lang 属性指定适当的语言代码。
建议不使用: 对于不支持创建会话的应用程序,创建会话是不可行的。使用 lang 属性可得到相同的结果,而无须创建会话。
longdesc frame 指定框架长描述的 URI。此描述是对由 title 属性提供的简短描述的补充,对非可视用户代理可能会特别有用。
lowsrc img 为具有低分辨率图形卡的用户指定图像。
建议不使用: 在 HTML 4.01 规范中未定义此属性,在将来的 Struts 版本中将会除去该属性。
marginheight frame 指定要在框架的内容与框架顶部页边距及底部页边距之间保留的间隔(以像素计)。
marginwidth frame 指定要在框架的内容与框架左右页边距之间保留的间隔(以像素计)。
maxlength file、password 和 text 指定接受的最大输入字符数目。
message messages 如果设置为 true,则从 Globals.MESSAGE_KEY 常量字符串检索 bean 并忽略指定给 name 属性的任何值。缺省情况下,该标记从 Globals.ERROR_KEY 常量字符串检索将对其进行迭代的 bean。
method form 和 javascript 指定将用来提交此请求的 HTTP 方法(GETPOST)。
multiple select 指定接受的最大输入字符数目。
name checkbox、errors、file、form、frame、hidden、img、link、messages、multibox、options、password、radio、rewrite、select、text、textarea 和 include 指定这样一个 JSP bean 的名称:它包含表示查询参数的映射(如果未指定 property),或者它的属性 getter 被调用来返回一个映射(如果指定了 property)。
name optionsCollection 指定呈示此输入字段的当前值时要参考其属性的 bean 的属性名称。缺省情况下,将使用与嵌套此元素的表单标记相关联的 bean。
noresize frame 如果设置为 true,则会阻止用户调整框架的大小。缺省值为 false
onblur button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素失去输入焦点时运行 JavaScript 事件处理程序。
onchange button、cancel、checkbox、file、hidden、image、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素失去输入焦点且其值已更改时运行 JavaScript 事件处理程序。
onclick button、cancel、checkbox、file、hidden、image、img、link、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素接收到鼠标单击时运行 JavaScript 事件处理程序。
ondblclick button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素接收到鼠标双击时运行 JavaScript 事件处理程序。
onfocus button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素接收到输入焦点时运行 JavaScript 事件处理程序。
onkeydown button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素具有焦点且某一键被按下时运行 JavaScript 事件处理程序。
onkeypress button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素具有焦点且某一键被按下又放开时运行 JavaScript 事件处理程序。
onkeyup button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在此元素具有焦点且某一键被放开时运行 JavaScript 事件处理程序。
onmousedown button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在鼠标指针指向此元素且按下鼠标按键时运行 JavaScript 事件处理程序。
onmousemove button、cancel、checkbox、file、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 在鼠标指针指向此元素且移动指针时运行 JavaScript 事件处理程序。
onmouseout button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 在鼠标指针先前指向此元素但指针后来被移到元素外时运行 JavaScript 事件处理程序。
onmouseover button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 在鼠标指针先前未指向此元素但指针后来被移到元素内时运行 JavaScript 事件处理程序。
onmouseup button、cancel、checkbox、file、hidden、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 在鼠标指针指向此元素且放开鼠标按键时运行 JavaScript 事件处理程序。
onreset form 如果表单被复位,则运行 JavaScript 事件处理程序。
onsubmit form 如果表单被提交,则运行 JavaScript 事件处理程序。
page frame、image、img、javascript、link、include 和 rewrite 指定模块相对路径(以斜杠(/)开头),此超链接在被激活时将把控制转移至该路径。必须指定下列其中一项属性:actionforwardhrefpage。可以通过添加 paramIdname 属性来动态修改此超链接。
pageKey image 和 img 指定消息资源字符串的键,该字符串指定此输入标记的图像的模块相对路径。
paramId frame、img、link 和 rewrite 指定将被动态添加至所生成超链接的请求参数的名称。相应的值是由 paramName 属性和(可选)paramProperty 属性定义的,并且可选择由 paramScope 属性指定范围。
paramName frame、img、link 和 rewrite 指定这样一个 JSP bean 的名称:它是包含由 paramId 命名的请求参数的值的字符串(如果省略 paramProperty),或它的属性 getter 被调用来返回一个字符串(如果指定 paramProperty)。如果指定了 paramScope 属性,则该 JSP bean 就限于由该属性指定的 bean 范围。
paramProperty frame、img、link 和 rewrite 指定由 paramName 属性指定的 bean 的属性的名称,其返回值必须是包含请求参数(由 paramId 属性命名)的值的字符串,而该请求参数将被动态添加至此超链接。
paramScope frame、img、link 和 rewrite 指定在其中搜索由 paramName 属性指定的 bean 的范围。缺省情况下,将搜索所有范围。
property button、checkbox、file、multibox、password 和 select 指定随此提交附带的请求参数的名称,它被设置为指定值。[必填]
property cancel 指定随此提交附带的请求参数的名称,它被设置为指定值。
注意: 如果将此属性设置为缺省值以外的值,则该属性不会被 Struts 控制器 servlet 或 Action.isCancelled() 方法识别为 Cancel 键。您将需要自己进行取消检测。
property errors 指定应对其显示错误消息的属性的名称。缺省情况下,将显示所有错误消息(而无论属性如何)。
property frame、img、link 和 rewrite 指定 name 属性指定的 bean 的属性的名称,其返回值必须是包含要被添加至超链接的查询参数的 java.util.Map 类。如果指定此属性,则还必须同时指定 name 属性。
property hidden 如果未指定 value,则指定此输入字段的名称及相应 bean 属性的名称。相应的 bean 属性(如果存在)的类型必须是“字符串”。[必填]
property image 指定此图像标记的属性名。请求的各参数名都将显示为 property.xproperty.yxy 表示此图像的鼠标单击的坐标。通过表单 bean 检索这些值的一种方法是定义 getX()、getY()、setX() 和 setY() 方法,并将属性指定为空白字符串(property="")。
property messages 指定应对其显示消息的属性的名称。缺省情况下,将显示所有消息(而无论属性如何)。
property options 为这些选项指定表单 bean 或由 name 属性指定的 bean(它将返回所返回至服务器的值的集合)的属性。
property radio 指定此 radio 标记的相应 bean 属性。[必填]
property reset 指定将要生成的输入字段的名称。
property text 和 textarea 指定此输入字段的名称,以及相应 bean 属性的名称(如果未指定 value)。相应的 bean 属性(如果存在)的类型必须是“字符串”。[必填]
readonly password、text 和 textarea 如果设置为 true,则使此输入字段成为只读字段。
redisplay password 如果设置为 false,就表示不会重新显示现有值。即使重新显示的值在可视的 HTML 页上显示为星号,也还是可以通过客户机浏览器的“显示页源代码”菜单选项看到实际密码值的明文。缺省值为 true。可在登录页上将此值设置为 false
rows textarea 指定要显示的行数。
scope frame、img、link 和 rewrite 指定在其中搜索由 name 属性指定的 bean 的范围。缺省情况下,将搜索所有范围。
scrolling frame 指定是无条件地创建滚动条(yes)、永不创建(no)还是仅在需要时才创建(auto)。
server base 指定用来代替 request.getServerName() 的服务器名。
size file、password、select 和 text 指定要分配的字符位置数目。
src frame、image、img 和 javascript 指定此输入标记的图像的源 URL。
srcKey image 和 img 指定消息资源字符串的键,该字符串指定此输入标记的图像的源 URL。
staticJavascript javascript 指定是否呈示静态 JavaScript 代码。缺省值为 true
style button、cancel、checkbox、file、form、frame、hidden、image、img、link、multibox、option、options、optionsCollection、password、radio、reset、select、submit、text 和 textarea 为组件指定 CSS 样式信息(例如,style="font-size : 8pt ; color : red")。
styleClass button、cancel、checkbox、file、form、frame、hidden、image、img、link、multibox、option、options、optionsCollection、password、radio、reset、select、submit、text 和 textarea 指定要应用于此 HTML 元素的 CSS 样式表类。这将创建 class 属性。
styleId button、cancel、checkbox、file、form、frame、hidden、image、img、link、multibox、option、password、radio、reset、select、submit、text 和 textarea 指定要赋予此 HTML 元素的标识。这将创建 id 属性。
tabindex button、cancel、checkbox、file、image、link、multibox、password、radio、reset、select、submit、text 和 textarea 设置此元素的跳进顺序(升序正整数)。
target base、form 和 link 指定此表单提交至的窗口目标,如用于带框架表示的情况。
title button、cancel、checkbox、file、frame、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 指定此元素的建议标题。
titleKey button、cancel、checkbox、file、frame、hidden、image、img、link、multibox、password、radio、reset、select、submit、text 和 textarea 指定此元素的建议标题的消息资源键。
transaction frame、link、include 和 rewrite 如果设置为 true,则将任何当前事务控制标记都包括在生成的超链接中,以使它在接收操作中传递 isTokenValid() 测试。
type form 指定指示正在生成的表单类型的表单 bean 类的名称。
usemap img 指定在此页内定义的映射的名称,该映射用于映射此图像的热点区域。
value button、cancel、image、password、radio、reset 和 submit 指定要置于此按钮上的标注的值。此值还将作为指定请求参数的值提交。
value checkbox 和 multibox 如果提交表单时选择了此复选框,则指定要传送的值。缺省情况下,如果选择了该复选框,将返回值 on
value file、hidden、text 和 textarea 指定此字段应被初始化为的值。
value option 指定在用户选择了此选项的情况下要对此字段提交的值。[必填]
value optionsCollection 指定(表示要为每个选项呈示的值的)集合中的 bean 的属性。缺省值为 value
value select 指定要比较的值以对选择的选项作标记。
vspace img 指定图像与文本之间(上面和下面)的垂直间隔。
width img 指定所显示的图像的宽度。指定此属性以及 height 属性有助于加快浏览器呈示页的速度。
write hidden 如果设置为 true,则除创建一个 HTML type="hidden" 元素外,还将此字段的值呈示到响应页以使该值可视。缺省情况下,仅创建 hidden 元素。
xhtml html 如果设置为 true,则在生成的 html 元素上呈示 xml:langxmlns 属性。这还使得所有其它 html 标记都呈示为 XHTML 1.0。(<html:xhtml/> 标记具有类似用途。)

相关任务
将 Struts 标记添加至 JSP 文件

相关参考
Struts bean 标记的属性
Struts 平铺标记的属性
Struts 逻辑标记的属性
Struts 嵌套标记的属性
Struts 标记的属性

使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.