by Budi Kurniawan
在本文系列的第一部分中我講述瞭如何使用Struts提供的HTML標籤庫來配置一個Struts應用程序。我還介紹了該標籤庫中的一類標籤:獨立使用的標籤。在第二部分中我將繼續介紹第二類標籤:與form相關的標籤。
與form相關的標籤包括
標籤本身以及所有必須包含在其中的標籤。比如,和 標籤就是和form相關的標籤,因爲如果不把它們放到一個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相關的標籤。在使用這些標籤之前,你必須依照一些規則以便正確地運用它們。第三部分將講述如何在真正的程序中使用這些標籤。