Struts提供的和Form相關的標籤(轉)

繼續學習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" > <?xml:namespace prefix = html />

那麼你的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相關的標籤。在使用這些標籤之前,你必須依照一些規則以便正確地運用它們。第三部分將講述如何在真正的程序中使用這些標籤。


 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章