struts html 标签详解
HTML 标签
用来创建能够和Struts框架和其他相应的HTML标签交互的HTML输入表单
Bean标签
在访问JavaBeans及其属性,以及定义一个新的bean时使用
Logic标签
管理条件产生的输出和对象集产生的循环
Template标签
随着Tiles框架包的出现,此标记已开始减少使用
Nested标签
增强对其他的Struts 标签的嵌套使用的能力标签的公共特征
使用固定属性名称的Struts 标签:
属性
说明
id
命名自定义标签创建时的脚本变量名。
name
指出关键字值,在该关键字下可以找到一个存在的bean。如果给出了scope属性,则仅仅在scope中查找。否则,根据标准的顺序在各种scope中查找:(page,request,session,orapplication)。
property
指出bean中的某个属性,可以在其中检索值。如果没有标明,则使用对象本身的值。
scope
定义了Bean在哪个范围(page, request, session, or application)中被查找。如果没有标明按顺序查找。脚本变量(见id)将在相同的范围中创建。Struts 标签也支持嵌套引用,例如:
Property="foo.bar.baz"
这相当于进行下面的调用:getFoo().getBar().getBaz();
或者做为setter:getFoo().getBar().setBaz(value);
虽然Struts 标签的设计原意是为了避免使用scriptlet,scriptlet的表达式还能够提供给所有的Struts 标签使用。但请确保使用完整的表达式:
错误:
<html:linkhref="'<%="/"+name%>/index.jsp>'>
正确:
<html:link href="'<%= "/" + name + "/index.jsp" %>'> // 表达式必须提供整个属性值Html 标签库
1. <html>标签它有两个属性:locale和xhtml,两者都不是必需的。
<html:html locale=\"true\">
此行代码解析后:<html lang=\"en\">
2. 说明:生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器,你不需要改变代码,Locale会自动调整。
3. <base>标签:表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。
<html:base/>
此行代码解析后:<base href=\"http://www.mymain.com/myStrutsApp/testing.jsp\">
4. <img>标签
最重要的属性page:图象文件的路径,前面必须带有一个斜线。
其它属性:heignt、width、alt。<html:img page=\"/logo.gif\" height=\"50\" width=\"200\" alt=\"Web Logo\"/>
5. <link>标签
<html:link page=\"/index.html\">Click demo</html:link>
此行代码解析后:<a href=\"/index.html\">Click demo</a>
6. <errors>标签:通过一个简单的<html:errors/>标签,你就可以在一个JSP页面上显示完全自定义的错误信息。功能超强大!!
说明:这个标签在Request对象的属性集合中查找reservedkey。如果它找到一个reservedkey,它就假设这个key是一个String、或是一个String数组
(它包含在模块的MessageResources中查找的messagekeys)、或是类型为org.apache.struts.action.ActionErrors的一个对象。
如果在应用程序资源中存在相应的信息,那么就可以用下面这些可选的messagekeys:
·errors.headerorerrors.prefix:相应的信息在错误信息的单独列表前显示。
· errors.footer or errors.suffix:相应的信息在错误信息的单独列表后显示。7. <form>标签系列使用<form>标签时必须遵循一些规则:
1. 标签中必须包含一个action属性,它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性,它的值是form bean的名称。
<html:form action=\"/login\" >
如果你有上述一个标签 ,那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素:
<action-mappings>
<actionpath=\"/login\"
type=\"com.javapro.struts.LoginAction\"
name=\"loginForm\"
scope=\"request\"
input=\"/login.jsp\">
<forwardname=\"success\"path=\"/mainMenu.jsp\"/>
</action>
.
.
.
</action-mappings> // 这就是说一个form标签是和form bean相关联的。2.
3. 任何包含在<form>中用来接收用户输入的标签(<text>、<password>、<hidden>、<textarea>、<radio>、<checkbox>、<select>)必须在相关的form bean中有一个指定的属性值。比如,如果你有一个属性值被指定为“username”的<text>标签,那么相关的form bean中也必须有一个名为“username”的属性。输入<text>标签中的值会被用于生成form bean的userName属性。
<form>标签还有一些不是必须但很有用的“次要”属性。
比如,你可以用focus属性来生成JavaScript,它会“定焦”(focus)到该form所包含的一个元素上。使用focus属性时你需要给它指定元素的名称。<body>
<html:formaction=\"/login\"focus=\"password\">
UserName:<html:textproperty=\"userName\"/>
<br>Password:<html:textproperty=\"password\"/>
<br><html:submit/>
</html:form>
</body>代码解析后:
<body>
<formname=\"loginForm\"method=\"post\"action=\"/myStrutsApp/login.do\">
UserName:<inputtype=\"text\"name=\"userName\"value=\"\">
<br>Password:<inputtype=\"text\"name=\"password\"value=\"\">
<br><inputtype=\"submit\"value=\"Submit\">
</form>
<scriptlanguage=\"JavaScript\"type=\"text/javascript\">
<!--
if(document.forms[\"loginForm\"].elements[\"password\"].type!=\"hidden\")
document.forms[\"loginForm\"].elements[\"password\"].focus()
//-->
</script></body>
有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程,它会帮你自动生成。还可以看到,<form>标签中method属性的缺省值是POST。
<text>标签、<hidden>标签、<textarea>标签、<radio>标签、<checkbox>标签、<submit>标签、<reset>标签:都有一个property属性,最后会被转换成HTML中的name属性,当然还有name和value属性。
<password>标签
<html:password property=\"password\" redisplay=\"false\"/>
该标签中的一个很重要的属性是"redisplay",它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而,为了使password不能被重新显示,你或许希望将该属性的值设为false。
<select>标签和<option>标签:
<html:select property=\"color\" size=\"3\">
<html:optionvalue=\"r\">red</html:option>
<html:optionvalue=\"g\">green</html:option>
<html:optionvalue=\"b\">blue</html:option>
</html:select>遗补:1.) <html:link>标签
forward属性:链接到一个global forward上;action属性:链接到一个action mapping上;href属性:这个链接会转发给控制器,由控制器做决定;page属性:一个相对的链接。
用page属性链接到action上:
<html:link page="/html-link.do">
Linkingwiththepageattribute.
</html:link>注意,上面的代码中你不必指定web的关联。相反的,如果你使用href属性,你就必须像下面所示指出web的关联(这里的关联就是struts-exercise):
<html:link href="/struts-exercise-taglib/html-link.do">
UsingHref
</html:link>很明显,当你在相同的web应用程序中做链接是,它比page属性更加好。你也能用href在不同的服务器上创建链接:
BooleanviaparamId,paramName,andparamValue
</a>java.util.HashMapnewValues=newjava.util.HashMap();
newValues.put("floatProperty",newFloat(444.0));
newValues.put("intProperty",newInteger(555));
newValues.put("stringArray",newString[]
{"Value1","Value2","Value3"});
pageContext.setAttribute("newValues",newValues);
<html:linkaction="/html-link"name="newValues">
Float,int,andstringArrayvianame(Map)
</html:link>你也能够链接到Map类型的action上,上面的代码解析后的结果:
<tr><td><%=pageContext.getAttribute("msg")%></td></tr>
</html:messages><html:selectproperty="name"size=6multiple="true">
<html:option>的属性:key、local、bundle-指定ResourceBundle中的内容。
例如<html:optionvalue="color1">Orange</html:option>
<html:optionvalue="color1"bundle="htmlselect.Colors"key="htmlselect.red"/>
<message-resource>中配置的资源文件为HtmlSelectColors.properties,相关内容为htmlselect.red=RED
<html:options>标签,提供了一组<option>元素,在<html:select>元素中可以包含多个<html:options>元素。非常灵活,可以取得集合或数组中的值。
<html:optionsCollection>标签,和<html:options>的用法很相似。
这个标签和org.apache.structs.util.LabelValueBean结合的很好,如果把label和value都放到这个对象中,可以很简单的这样应用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>