SpringMVC（18）：使用spring表单标签

本文详细介绍了SpringMVC中的JSTL表单标签使用方法，包括form、input、password、checkbox、radiobutton等标签的具体应用示例，并解释了如何利用这些标签进行数据绑定。

2018/1/23

【1】JSTL标签使用示例：

<%@ taglib prefix="fm" uri="http://www.springframework.org/tags/form" %>

	<fm:form method="post" modelAttribute="user" action="${pageContext.request.contextPath}/user/useraddsave" >
		<fm:errors path="userCode"></fm:errors>
		用户编码 ：<fm:input path="userCode" /><br/>
		<fm:errors path="userName"></fm:errors>
		用户名称 ：<fm:input path="userName"/><br/>
		<fm:errors path="userPassword"></fm:errors>
		用户密码 ：<fm:password path="userPassword"/><br>
		用户地址 ：<fm:input path="address" /><br>
		用户电话 ： <fm:input path="phone"/><br>
		<fm:errors path="birthday"></fm:errors>
		用户生日 ：<fm:input path="birthday" /><br>
		
		用户性别： <fm:radiobutton path="gender" value="1"/>女
			   <fm:radiobutton path="gender" value="2"/>男<br>		
		用户角色 ：<br>
				  <fm:radiobutton path="userRole" value="101" />OrdinaryUser 
				  <fm:radiobutton path="userRole" value="110"/>Administrator<br>
				  <fm:radiobutton path="userRole" value="111"/>Manager 
				  <fm:radiobutton path="userRole" value="100"/>tour<br>
		<input type="submit" name="保存"/>
		<input type="reset" value="重置"/>
	</fm:form>

下面介绍各个标签的使用方法。

【2】form标签：

<form:form modelAttribute="contentModel" method="post">

modelAttribute属性指定该form绑定的是哪个Model，当指定了对应的Model后就可以在form标签内部其它表单标签上通过为path指定Model属性的名称来绑定Model中的数据了，method属性指定form的提交方式如GET、POST等。

【3】.input标签：

<form:input path="username"/>

会生成一个type为text的Html input标签，通过path属性来指定要绑定的Model中的值。

【4】.password标签：

<form:password path="password"/>

会生成一个type为password的Html input标签，通过path属性来指定要绑定的Model中的值。

【5】.checkbox标签：

会生成一个type为checkbox的Html input标签，支持绑定boolean、数组、List或Set类型的数据。

绑定boolean数据会生成一个复选框，当boolean为true该复选框为选定状态，false为不选定状态。

<form:checkbox path="testBoolean"/>

绑定数组、List或Set类型的数据（以数组作为演示）如果绑定的数据中有对应checkbox指定的value时则为选定状态，反之为不选定状态：

绑定Array的checkbox 标签：<br/>
<form:checkbox path="testArray" value="arrayItem 路人甲"/>arrayItem 路人甲
<form:checkbox path="testArray" value="arrayItem 路人乙"/>arrayItem 路人乙
<form:checkbox path="testArray" value="arrayItem 路人丙"/>arrayItem 路人丙
<form:checkbox path="testArray" value="arrayItem 路人丁"/>arrayItem 路人丁

【6】.checkboxs标签：

会根据绑定的items数据生成一组对应的type为checkbox的Html input标签，绑定的数据可以是数组、集合或Map，其中checkboxs的path属性也必指定，当path中的数据有和items中的数据值同的时候对应的checkbox为选定状态，反之为不选定状态。

绑定集合数据（以数组作为演示）：

绑定Array的checkboxs 标签：<br/>
<form:checkboxes path="selectArray" items="${contentModel.testArray}"/>

这里需要注意的是当使用EL表达式绑定时需要连Model的名称一起指定如${contentModel.testArray}而不能像path一样只指定Model对应的属性名称。

但通常情况下我们需要的是checkbox显示的是名称，但选择后提交的是对应名称的值，比如id，我们就可以通过绑定Map来实现这个功能：

绑定Map的checkboxs 标签：<br/>
<form:checkboxes path="selectIds" items="${contentModel.testMap}"/>

生成的一组checkbox中其中一个checkbox的html代码：

<span><input id="selectIds1" name="selectIds" type="checkbox" value="1" checked="checked"/><label for="selectIds1">mapItem 路人甲</label></span>

【7】.radiobutton标签：

会生成一个type为radio的Html input标签，如果绑定的数据的值对应radiobutton指定的value时则为选定状态，反之为不选定状态：

绑定Integer的radiobutton 标签：<br/>
<form:radiobutton path="radiobuttonId" value="0"/>0
<form:radiobutton path="radiobuttonId" value="1"/>1
<form:radiobutton path="radiobuttonId" value="2"/>2

【8】.radiobuttons标签：

会根据绑定的items数据生成一组对应的type为radio的Html input标签，绑定的items数据可以是数组、集合或Map，其中radiobuttons的path属性也必指定，当path的值和items中的某条数据值相同的时候对应的radio为选定状态，反之为不选定状态，用法和checkboxs很相似。但要注意的是：checkboxs的path绑定的是集合radiobuttons的path绑定的是单个值：

绑定Map的radiobuttons 标签：<br/>
<form:radiobuttons path="selectId" items="${contentModel.testMap}"/>

【9】.select标签：

会生成一个Html select标签，绑定的items数据可以是数组、集合或Map会根据items的内容生成select里面的option选项，当path的值和items中的某条数据值相同的时候对应的option为选定状态，反之为不选定状态，用法与radiobuttons很相似：

绑定Map的select 标签：<br/>
<form:select path="selectId" items="${contentModel.testMap}"/>

上面的是根据指定的items自动生成的option选项，但我们也可以不指定items手动添加select的option选项：

不绑定items数据直接在form:option添加的select 标签：<br/>
<form:select path="selectId">  
   <option>请选择人员</option>
   <form:option value="1">路人甲</form:option>
   <form:option value="2">路人乙</form:option>
   <form:option value="3">路人丙</form:option>
</form:select>

其中添加<option>请选择人员</option> 可以让在没有进行选择的情况下不指定任何默认值。

下面看一下form:option 与option的区别：

不绑定items数据直接在form:option添加的select 标签：<br/>
<form:select path="selectId">  
   <option>请选择人员</option>
   <form:option value="1">路人甲</form:option>
   <form:option value="2">路人乙</form:option>
   <form:option value="3">路人丙</form:option>
</form:select><br/>
不绑定items数据直接在html的option添加的select 标签：<br/>
<form:select path="selectId">  
   <option>请选择人员</option> 
   <option value="1">路人甲</option>
   <option value="2">路人乙</option>
   <option value="3">路人丙</option>  
</form:select><br/>

由截图的结果可以看出form:option 正确选择了path中指定的selectId而option没有，说明form:option有数据绑定功能option没有。

另外我们也可以不为select指定items，而把items指定到form:option 上这两种效果基本是一样的，一点区别就是为select指定items再在select里面添加option是不起作用的会被items生成的option覆盖掉，而把items指定到form:option 上则可以再在select里面添加option：

用form:option绑定items的select 标签：<br/>
<form:select path="selectId">  
    <option/>请选择人员
    <form:options items="${contentModel.testMap}"/>  
</form:select>

【10】.textarea标签：

textarea 标签：
<form:textarea path="remark"/>

会生成一个Html textarea标签，通过path属性来指定要绑定的Model中的值。

【11】.hidden标签：

会生成一个type为hidden的Html input标签，通过path属性来指定要绑定的Model中的值。

【12】.errors标签：

errors标签的用法在系列（6）—>数据验证中已经说明了，这里不在赘述。

Spring MVC表单标签的内容到此结束。