[Taglib]struts标签之html手册

<html:checkbox name="checkboxForm" property="one">
One
</html:checkbox>
<html:checkbox name="checkboxForm" property="two">
Two
</html:checkbox>
<html:checkbox name="checkboxForm" property="three">
Three
</html:checkbox>
如果选中后被提交则相应的属性的值为 true 。
回页首
html:radio
html:radio 标签生成一个 radio 。主要的用法有两种，下面我们通过代码来示例。
下面的代码示例了 html:radio 标签的一般用法，如果被提交则选中的 radio 的 value 值将被提交到 radioForm 中的 id 中。

<html:radio name="radioForm" property="id" value="00001">
One
</html:radio>
<html:radio name="radioForm" property="id" value="00002">
Two
</html:radio>
下面的代码示例了 html:radio 标签的典型用法，其中的 persons 和 bean:define 标签中的一致，您可以参考 bean:define 标签。我只介绍这个 <html:radio idName="person" property="id" value="id"> ， idName 指定 html:radio 要使用的 bean( 这里为 person) ， value="id" 表示 person 的 id 属性将作为 radio 元素的 value 值而 property="id" 表示提交时选中的 radio 的值将被提交给 radioForm 中的 id 属性。

<logic:notEmpty name="radioForm" property="persons">
<logic:iterate id="person" name="radioForm" property="persons">
<html:radio idName="person" property="id" value="id">
<bean:write name="person" property="name"/>
</html:radio>
</logic:iterate>
</logic:notEmpty>
回页首
html:multibox
html:multibox 标签生成多个 checkbox 。当您要使用大量的 checkbox 时使用这个标签非常方便，可以使您避免在 ActionForm 中声明大量的 boolean 类型的变量，带之以一个数组就行了。
注意 : 为了正确的处理没有选中的 checkbox 您必须在 reset() 中设置数组的长度为 0 。
下面的代码示例了 html:multibox 标签的一般用法，如果被提交则选中的所有 checkbox 的 value 值将被提交到 multiboxForm 中的 selectedItems 中，这是一个 String[] 数组。

<html:multibox name="multiboxForm" property="selectedItems"
value="00001"/>
<html:multibox name="multiboxForm" property="selectedItems"
value="00002"/>
下面的代码示例了 html:multibox 标签的典型用法：

<logic:iterate id="person" name="multiboxForm" property="persons">
<html:multibox property="selectedItems">
<bean:write name="person" property="id"/>
</html:multibox>
<bean:write name="person" property="name"/>
</logic:iterate>
回页首
html:link
html:link 标签生成一个锚点 (<a>) 元素。我从 html:link 标签如何构造基本 url 和如何构造 query 参数两个方面来介绍这个标签。
构造基本 url 是依据该标签的如下四个属性进行的，这四个属性一次只能出现一个。让我们看看它们：

forward ，指定一个全局 ActionForward 的名称。另外如果 forward 是 module 相关的则该 forward 必须指向一个 action 而不能是一个页面。
action ，指定一个 Action 的名称。
href ， struts 会直接使用这个值而不会对其进行任何处理。
page ，指定一个页面的路径，必须以 / 开始。
构造 query 参数，下面列举了可能的形式，其中 baseurl 只是一个占位符：

baseurl?p=00001( 单参单值 )
baseurl?p1=00001&p2=00002&p3=00003( 多参单值 )
baseurl?p=00001&p=00002&p=00003( 单参多值 )
baseurl?p1=00001&p2=00002&p=00001&p=00002&p=00003( 混合 )
下面我们以代码示例来说明每一种 html:link 的用法，首先让我们花点时间看看相关 action 中的代码：

<!-- 下面所有代码的数据都是在这里构造的 -->
public ActionForward execute(ActionMapping mapping,ActionForm form,
HttpServletRequest request,HttpServletResponse response) {

DataForm dataForm = (DataForm) form;

dataForm.setParam("00001");

HashMap paramSingleMap = new HashMap();
paramSingleMap.put("p1","00001");
paramSingleMap.put("p2","00002");
paramSingleMap.put("p3","00003");
dataForm.setParamSingleMap(paramSingleMap);

HashMap paramMultiMap = new HashMap();
paramMultiMap.put("p",new String[]{"00001","00002","00003"});
dataForm.setParamMultiMap(paramMultiMap);

HashMap paramSMMap = new HashMap();
paramSMMap.put("p1","00001");
paramSMMap.put("p2","00002");
paramSMMap.put("p",new String[]{"00001","00002","00003"});
dataForm.setParamSMMap(paramSMMap);

List<Person> persons = new ArrayList<Person>();
Person person1 = new Person();
person1.setId("00001");
person1.setName(" 赵辰 ");
Person person2 = new Person();
person2.setId("00002");
person2.setName(" 李为芳 ");
Person person3 = new Person();
person3.setId("00003");
person3.setName(" 王微 ");
persons.add(person1);
persons.add(person2);
persons.add(person3);
dataForm.setPersons(persons);

return mapping.findForward("success");
}

<!-- 这用来设置一个位置 -->
<html:link linkName="top"/>
<!-- 这用来定位到上面的那个位置 -->
<html:link page="/link.do" anchor="top">Go Top</html:link>

<html:link page="/link.do" paramId="p" paramName="dataForm"
paramProperty="param">
单参单值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramSingleMap">
多参单值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramMultiMap">
单参多值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramSMMap">
混合
</html:link>
下面的代码示例了 html:link 标签的 indexed 属性和 indexId 属性的用法，这两个属性只有 html:link 标签嵌套在 logic:iterate 标签中时才可用。

<logic:iterate id="person" name="dataForm" property="persons">
<html:link action="/link.do" paramId="person" paramName="person"
paramProperty="id" indexed="true" indexId="number">
person
</html:link>
<br/>
</logic:iterate>
<!-- 下面是上面代码的运行结果 ( 产生的 html)
<a href="/struts-demo/link.do?person=00001&number=0"> 赵辰 </a><br/>
<a href="/struts-demo/link.do?person=00002&number=1"> 李为芳 </a><br/>
<a href="/struts-demo/link.do?person=00003&number=2"> 王微 </a><br/>
其中的 number 是由 indexId="number" 确定的，而该参数的值为元素在集合中的位置。
-->

html:rewrite 标签和 html:link 标签类似只是不生成锚点 (<a>) ，而是简单的输出字符串。
回页首
html:errors
html:errors 标签和 html:messages 标签的功能相似，所以我们放到一起来介绍。

html:errors 标签将由 name 属性指定的 ActionMessages 、 ActionErrors 、 String 和 String[] 直接输出到页面中。

html:messages 标签将用由 name 属性 ( 注意 message 属性值对它的影响 ) 指定的 ActionMessages 、 ActionErrors 、 String 和 String[] 创建一个新的属性和 scripting 变量，使用 id 属性值作为名称。

html:errors 标签和 html:messages 标签的 property 属性是用来为 errors 和 messages 分类的。我们可以给这两个标签指定 property 属性，以便只显示某一类的错误或消息。
在资源文件增加了如下的内容：

# -- standard errors --
errors.header=<ul>
errors.prefix=<li>
errors.suffix=</li>
errors.footer=</ul>

error=error with none value .
error1=error1 with one value is {0} .
error2=error2 with two values are {0} , {1} .
error3=error3 with three values are {0} , {1} , {2} .
error4=error4 with four values are {0} , {1} , {2} ,{3} .
下面的代码示例了 actionErrors 的构造：

public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors actionErrors = new ActionErrors();
actionErrors.add("property1",
new ActionMessage("error"));
actionErrors.add("property2",
new ActionMessage("error1","value0"));
actionErrors.add("property2",
new ActionMessage("error2","value0","value1"));
actionErrors.add("property3",
new ActionMessage("error3","value0","value1","value2"));
actionErrors.add("property3",
new ActionMessage("error4","value0","value1","value2","value3"));

actionErrors.add("property4",
new ActionMessage("error1",new Object[]{"value0"}));
actionErrors.add("property4",
new ActionMessage("error2",new Object[]{"value0","value1"}));
actionErrors.add("property4",
new ActionMessage("error3",new Object[]{"value0","value1",
"value2"}));
actionErrors.add("property5",
new ActionMessage("error4",new Object[]{"value0","value1",
"value2","value3"}));

actionErrors.add("notBundle",
new ActionMessage("not a bundle key",false));
return actionErrors;
}

errors 标签代码示例：

<html:errors/>
<br/>
<html:errors property="property4"/>

messages 标签代码示例：

<logic:messagesPresent>
<ul>
<html:messages id="message">
<li><bean:write name="message"/></li>
</html:messages>
</ul>
</logic:messagesPresent>
<br/>
<logic:messagesPresent>
<ul>
<html:messages id="message" property="property4">
<li><bean:write name="message"/></li>
</html:messages>
</ul>
</logic:messagesPresent>

图示 2. 上面的两段代码示例运行结果相同，如下所示：


html:javascript
html:javascript 标签生成用于校验的 javascript 脚本代码。
下面的代码片段示例了 html:javascript 标签的基本用法，其中 formName 属性的值是在 validation.xml 文件的 <formset> 中定义的 form 的名称。有一点值得注意的是在确定 <formset> 时要使用合适的 language 属性值。

<html:javascript formName="dataForm"/>


html:xhtml
html:xhtml 标签在页面中一出现就是告诉该页的所有其它的 Struts html 标签以 XHTML1.0 兼容的形式输出。这和将 html:html 标签的 xhtml 属性值指定为 true 有些类似。如果上述情况都没有出现， Struts html 标签将以 html4.01 兼容的形式输出。