JSF - h:message

h:message 標籤顯示與 UI 元素對應的訊息。

JSF 標籤

<h:inputText  id = "username"  size = "20" label = "UserName" required = "true"> 
   <f:validateLength for = "username" minimum = "5" maximum = "20" />    
</h:inputText> 
<h:message for = "username" style = "color:red" />

渲染輸出

如果輸入的使用者名稱超過 20 個字元。

<span style = "color:red">UserName: Validation Error:  
   Length is greater than allowable maximum of '20'</span>

如果輸入的使用者名稱少於 5 個字元。

<span style = "color:red">UserName: Validation Error:  
   Length is less than allowable minimum of '5'</span>

如果未輸入使用者名稱。

<span style = "color:red">UserName: Validation Error:  
   Value is required</span>

標籤屬性

序號	屬性和描述
1	id 元件的識別符號
2	binding 對元件的引用，可以在支援 Bean 中使用
3	rendered 布林值；false 抑制渲染
4	styleClass 級聯樣式表 (CSS) 類名稱
5	for 顯示其訊息的元件的 ID，僅適用於 h:message
6	errorClass 應用於錯誤訊息的 CSS 類
7	errorStyle 應用於錯誤訊息的 CSS 樣式
8	fatalClass 應用於致命訊息的 CSS 類
9	fatalStyle 應用於致命訊息的 CSS 樣式
10	globalOnly 僅顯示全域性訊息的指令，僅適用於 h:messages。預設值：false
11	infoClass 應用於資訊訊息的 CSS 類
12	infoStyle 應用於資訊訊息的 CSS 樣式
13	layout 訊息佈局的規範：表格或列表，僅適用於 h:messages
14	showDetail 一個布林值，確定是否顯示訊息詳細資訊。h:messages 的預設值為 false，h:message 的預設值為 true
15	showSummary 一個布林值，確定是否顯示訊息摘要。h:messages 的預設值為 true，h:message 的預設值為 false
16	tooltip 一個布林值，確定是否在工具提示中呈現訊息詳細資訊；僅當 showDetail 和 showSummary 為 true 時才呈現工具提示
17	warnClass 警告訊息的 CSS 類
18	warnStyle 警告訊息的 CSS 樣式
19	style 內聯樣式資訊
20	title 一個標題，用於輔助功能，描述一個元素。可視瀏覽器通常為標題的值建立工具提示

示例應用程式

讓我們建立一個測試 JSF 應用程式來測試上述標籤。

步驟	描述
1	在 com.tutorialspoint.test 包下建立一個名為 helloworld 的專案，如 JSF - 第一個應用程式章節中所述。
2	修改 home.xhtml，如下所述。保持其餘檔案不變。
3	編譯並執行應用程式以確保業務邏輯按要求工作。
4	最後，以 war 檔案的形式構建應用程式並將其部署到 Apache Tomcat Web 伺服器中。
5	使用適當的 URL 啟動您的 Web 應用程式，如下面的最後一步所述。

home.xhtml

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<html xmlns = "http://www.w3.org/1999/xhtml"> 
   <head> 
      <title>JSF Tutorial!</title> 
   </head> 
   
   <body> 
      <h2>h:messages example</h2> 
      <hr /> 
      
      <h:form> 
         <h:panelGrid id = "panel" columns = "3" border = "0" cellpadding = "10"  
               cellspacing = "1">   
            <h:outputLabel value = "Enter Username" /> 
            
            <h:inputText  id = "username"  size = "20" label = "UserName"  
               required = "true"> 
               <f:validateLength for = "username" minimum = "5" maximum = "20" />    
            </h:inputText> 
            <h:message for = "username" style = "color:red" /> 
            <h:outputLabel value = "Enter Password" /> 
            
            <h:inputSecret id = "password" size = "20" label = "Password"  
               required = "true" redisplay = "true" > 
               <f:validateLength for = "password" minimum = "5" maximum = "10" />  
            </h:inputSecret> 
            <h:message for = "password" style = "color:red" />    
            <h:commandButton id = "submit" value = "Submit" action = "result"/> 
         </h:panelGrid>      
      </h:form> 
   
   </body> 
</html>

準備好所有更改後，讓我們像在 JSF - 第一個應用程式章節中所做的那樣編譯並執行應用程式。如果應用程式一切正常，則會產生以下結果。

jsf_basic_tags.htm

列印頁面

上一個

下一個