本文档描述在 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 的全局操作逻辑名。必须指定下列其中一项属性:action、forward、href 或 page。可以通过添加 paramId 或 name 属性来动态修改此超链接。[对于 form 是必需的] |
align | image | 指定此图像的对齐方式。 Deprecated: 在 HTML 4 中建议了不要使用此属性,而建议使用 CSS。有关更多详细信息,请参阅 www.w3.org/TR/REC-html40/struct/objects.html#h-13.7.4。
|
align | img | 指定下列表示图像对齐方式的其中一个值:
|
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 的逻辑名。必须指定下列其中一项属性:action、forward、href 或 page。可以通过添加 paramId 或 name 属性来动态修改此超链接。 |
frameborder | frame | 如果设置为 1,则在此框架四周生成框架边框。缺省值为 0。 |
frameName | frame | 对呈示的 frame 元素的 name 属性指定值。 |
header | messages | 指定将在消息迭代开始之前打印的可选消息资源键。 |
height | img | 指定显示的图像的高度。指定此属性以及 width 属性有助于加快浏览器呈示页的速度。 |
href | frame、link、include 和 rewrite | 指定此超链接被激活时将控制转移至的 URL。必须指定下列其中一项属性:action、forward、href 或 page。可以通过添加 paramId 或 name 属性来动态修改此超链接。 |
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 属性指定适当的语言代码。 Deprecated: 对于不支持创建会话的应用程序,创建会话是不可行的。使用 lang 属性可得到相同的结果,而无须创建会话。
|
longdesc | frame | 指定框架长描述的 URI。此描述是对由 title 属性提供的简短描述的补充,对非可视用户代理可能会特别有用。 |
lowsrc | img | 为具有低分辨率图形卡的用户指定图像。 Deprecated: 在 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 方法(GET 或 POST)。 |
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 | 指定模块相对路径(以斜杠(/)开头),此超链接在被激活时将把控制转移至该路径。必须指定下列其中一项属性:action、forward、href 或 page。可以通过添加 paramId 或 name 属性来动态修改此超链接。 |
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.x 和 property.y,x 和 y 表示此图像的鼠标单击的坐标。通过表单 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:lang 和 xmlns 属性。这还使得所有其它 html 标记都呈示为 XHTML 1.0。(<html:xhtml/> 标记具有类似用途。) |