继续学习Struts提供的HTML标签库。
by Budi Kurniawan
在本文系列的第一部分中我讲述了如何使用Struts提供的HTML标签库来配置一个Struts应用程序。我还介绍了该标签库中的一类标签:独立使用的标签。在第二部分中我将继续介绍第二类标签:与form相关的标签。
与form相关的标签包括 标签本身以及所有必须包含在其中的标签。比如,和标签就是和form相关的标签,因为如果不把它们放到一个form中它们就没有意义。
标签
标签用于生成一个HTML form。使用该标签时必须遵循许多规则。
首先,标签中必须包含一个action属性,它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性,它的值是form bean的名称。
例如,如果你有这样一个标签: <html:form action=/"/login/" >
那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素: <action-mappings>
<action path=/"/login/"
type=/"com.javapro.struts.LoginAction/"
name=/"loginForm/"
scope=/"request/"
input=/"/login.jsp/">
<forward name=/"success/" path=/"/mainMenu.jsp/"/>
</action>
.
.
.
</action-mappings>
这就是说一个form标签是和form bean相关联的。
另一个要遵循的规则是:任何包含在<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属性时你需要给它指定元素的名称。比如,以下代码是定焦在第二个Text元素上的: <body>
<html:form action=/"/login/" focus=/"password/">
User Name: <html:text property=/"userName/"/>
<br>Password: <html:text property=/"password/"/>
<br><html:submit/>
</html:form>
</body>
该段代码会被转换成: <body>
<form name=/"loginForm/" method=/"post/"
action=/"/myStrutsApp6/login.do/">
User Name: <input type=/"text/" name=/"userName/"
value=/"/">
<br>Password: <input type=/"text/"
name=/"password/" value=/"/">
<br><input type=/"submit/"
value=/"Submit/">
</form>
<script language=/"JavaScript/"
type=/"text/javascript/">
<!--
if (document.forms[/"loginForm/"].elements[
/"password/"].type != /"hidden/")
document.forms[/"loginForm/"].elements[
/"password/"].focus()
// -->
</script>
</body>
注意,<form>标签中method属性的缺省值是POST。另外,有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程,它会帮你自动生成。
在运行前面的例子时还要注意,你必须有一个包含userName和password属性的相关form。
<text>标签
<text>标签用于生成一个文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。
例如: <html:text property=/"userName/"/>
会被转换成: <input type=/"text/" name=/"userName/" value=/"/">
<password>标签
<password>标签用于生成一个口令字(type password)的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。该标签中的一个很重要的属性是“redisplay”,它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而,为了使password不能被重新显示,你或许希望将该属性的值设为false。
例如: <html:password property=/"password/"
redisplay=/"false/"/>
会被转换成: <input type=/"password/" name=/"password/"
value=/"/">
<hidden>标签
<hidden>标签用于生成一个隐藏文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效:
例如: <html:hidden property=/"userName/"/>
会被转换成: <input type=/"hidden/" name=/"userName/" value=/"/">
<textarea>标签
<textarea>标签用于生成一个文本区元素(text area element)。它必须包含和相关form bean中的相同属性对应的“property”属性。
比如: <html:textarea property=/"details/"
cols=/"80/"
rows=/"20/"
value=/"Enter details here/"/>
会被转换成: <textarea name=/"details/" cols=/"80/"
rows=/"20/">Enter details here</textarea>
<radio>标签
<radio>标签用于显示一个单选按钮(radio button)。它必须包含“value”属性。比如这段代码: <html:radio property=/"title/" value=/"1/"/>Mr.
<html:radio property=/"title/" value=/"2/"/>Ms.
<html:radio property=/"title/" value=/"3/"/>Dr.
会被转换成这样的HTML: <input type=/"radio/" name=/"title/"
value=/"1/">Mr.
<input type=/"radio/" name=/"title/"
value=/"2/">Ms.
<input type=/"radio/" name=/"title/"
value=/"3/">Dr.
<checkbox>标签
<checkbox>标签用于显示checkbox类型的输入区域。比如: <html:checkbox property=
/"notify/"/>Please send me notification
会被转换成: <input type=/"checkbox/" name=/"notify/"
value=/"on/">Please send me notification
<submit>标签
<submit>标签用于生成提交类型(type submit)的输入区域。比如: <html:submit value=/"Login/"/>
会被转换成: <input type=/"submit/" value=/"Login/">
<reset>标签
<reset>标签用于生成重置类型(type reset)的输入区域。比如: <html:reset/>
会被转换成: <input type=/"reset/" value=/"Reset/">
<option>标签
<option>标签用于显示select box中的一个选项。参照下面的<select>标签。
<select>标签
<select>标签用于显示一个包含零个或更多选项的HTML选择元素。它必须被嵌入一个<form>标签中才有效。下面这个例子将说明如何使用该标签: <html:select property=/"color/" size=/"3/">
<html:option value=
/"r/">red</html:option>
<html:option value=
/"g/">green</html:option>
<html:option value=
/"b/">blue</html:option>
</html:select>
会被转换成: <select name=/"color/" size=/"3/"><option
value=/"r/">red</option>
<option value=/"g/">green</option>
<option value=/"b/">blue</option>
</select>
在本文系列的第二部分,你学到了一些更重要的和form相关的标签。在使用这些标签之前,你必须依照一些规则以便正确地运用它们。第三部分将讲述如何在真正的程序中使用这些标签。
by Budi Kurniawan
在本文系列的第一部分中我讲述了如何使用Struts提供的HTML标签库来配置一个Struts应用程序。我还介绍了该标签库中的一类标签:独立使用的标签。在第二部分中我将继续介绍第二类标签:与form相关的标签。
与form相关的标签包括 标签本身以及所有必须包含在其中的标签。比如,和标签就是和form相关的标签,因为如果不把它们放到一个form中它们就没有意义。
标签
标签用于生成一个HTML form。使用该标签时必须遵循许多规则。
首先,标签中必须包含一个action属性,它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性,它的值是form bean的名称。
例如,如果你有这样一个标签: <html:form action=/"/login/" >
那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素: <action-mappings>
<action path=/"/login/"
type=/"com.javapro.struts.LoginAction/"
name=/"loginForm/"
scope=/"request/"
input=/"/login.jsp/">
<forward name=/"success/" path=/"/mainMenu.jsp/"/>
</action>
.
.
.
</action-mappings>
这就是说一个form标签是和form bean相关联的。
另一个要遵循的规则是:任何包含在<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属性时你需要给它指定元素的名称。比如,以下代码是定焦在第二个Text元素上的: <body>
<html:form action=/"/login/" focus=/"password/">
User Name: <html:text property=/"userName/"/>
<br>Password: <html:text property=/"password/"/>
<br><html:submit/>
</html:form>
</body>
该段代码会被转换成: <body>
<form name=/"loginForm/" method=/"post/"
action=/"/myStrutsApp6/login.do/">
User Name: <input type=/"text/" name=/"userName/"
value=/"/">
<br>Password: <input type=/"text/"
name=/"password/" value=/"/">
<br><input type=/"submit/"
value=/"Submit/">
</form>
<script language=/"JavaScript/"
type=/"text/javascript/">
<!--
if (document.forms[/"loginForm/"].elements[
/"password/"].type != /"hidden/")
document.forms[/"loginForm/"].elements[
/"password/"].focus()
// -->
</script>
</body>
注意,<form>标签中method属性的缺省值是POST。另外,有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程,它会帮你自动生成。
在运行前面的例子时还要注意,你必须有一个包含userName和password属性的相关form。
<text>标签
<text>标签用于生成一个文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。
例如: <html:text property=/"userName/"/>
会被转换成: <input type=/"text/" name=/"userName/" value=/"/">
<password>标签
<password>标签用于生成一个口令字(type password)的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。该标签中的一个很重要的属性是“redisplay”,它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而,为了使password不能被重新显示,你或许希望将该属性的值设为false。
例如: <html:password property=/"password/"
redisplay=/"false/"/>
会被转换成: <input type=/"password/" name=/"password/"
value=/"/">
<hidden>标签
<hidden>标签用于生成一个隐藏文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效:
例如: <html:hidden property=/"userName/"/>
会被转换成: <input type=/"hidden/" name=/"userName/" value=/"/">
<textarea>标签
<textarea>标签用于生成一个文本区元素(text area element)。它必须包含和相关form bean中的相同属性对应的“property”属性。
比如: <html:textarea property=/"details/"
cols=/"80/"
rows=/"20/"
value=/"Enter details here/"/>
会被转换成: <textarea name=/"details/" cols=/"80/"
rows=/"20/">Enter details here</textarea>
<radio>标签
<radio>标签用于显示一个单选按钮(radio button)。它必须包含“value”属性。比如这段代码: <html:radio property=/"title/" value=/"1/"/>Mr.
<html:radio property=/"title/" value=/"2/"/>Ms.
<html:radio property=/"title/" value=/"3/"/>Dr.
会被转换成这样的HTML: <input type=/"radio/" name=/"title/"
value=/"1/">Mr.
<input type=/"radio/" name=/"title/"
value=/"2/">Ms.
<input type=/"radio/" name=/"title/"
value=/"3/">Dr.
<checkbox>标签
<checkbox>标签用于显示checkbox类型的输入区域。比如: <html:checkbox property=
/"notify/"/>Please send me notification
会被转换成: <input type=/"checkbox/" name=/"notify/"
value=/"on/">Please send me notification
<submit>标签
<submit>标签用于生成提交类型(type submit)的输入区域。比如: <html:submit value=/"Login/"/>
会被转换成: <input type=/"submit/" value=/"Login/">
<reset>标签
<reset>标签用于生成重置类型(type reset)的输入区域。比如: <html:reset/>
会被转换成: <input type=/"reset/" value=/"Reset/">
<option>标签
<option>标签用于显示select box中的一个选项。参照下面的<select>标签。
<select>标签
<select>标签用于显示一个包含零个或更多选项的HTML选择元素。它必须被嵌入一个<form>标签中才有效。下面这个例子将说明如何使用该标签: <html:select property=/"color/" size=/"3/">
<html:option value=
/"r/">red</html:option>
<html:option value=
/"g/">green</html:option>
<html:option value=
/"b/">blue</html:option>
</html:select>
会被转换成: <select name=/"color/" size=/"3/"><option
value=/"r/">red</option>
<option value=/"g/">green</option>
<option value=/"b/">blue</option>
</select>
在本文系列的第二部分,你学到了一些更重要的和form相关的标签。在使用这些标签之前,你必须依照一些规则以便正确地运用它们。第三部分将讲述如何在真正的程序中使用这些标签。