JSF - h: messaggio

Il tag h: message visualizza il messaggio corrispondente all'elemento dell'interfaccia utente.

Tag 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" />

Output renderizzato

Nel caso in cui il nome utente inserito sia più di 20 caratteri.

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

Nel caso in cui il nome utente inserito sia inferiore a 5 caratteri.

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

Nel caso in cui il nome utente non venga inserito.

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

Attributi dei tag

S.No	Attributo e descrizione
1	id Identificatore di un componente
2	binding Riferimento al componente che può essere utilizzato in un backing bean
3	rendered Un booleano; false sopprime il rendering
4	styleClass Nome della classe CSS (Cascading stylesheet)
5	for L'ID del componente di cui viene visualizzato il messaggio, applicabile solo a h: message
6	errorClass Classe CSS applicata ai messaggi di errore
7	errorStyle Stile CSS applicato ai messaggi di errore
8	fatalClass Classe CSS applicata ai messaggi fatali
9	fatalStyle Stile CSS applicato ai messaggi fatali
10	globalOnly Istruzione per visualizzare solo messaggi globali, applicabile solo a h: messages. Predefinito: false
11	infoClass Classe CSS applicata ai messaggi informativi
12	infoStyle Stile CSS applicato ai messaggi informativi
13	layout Specifica per il layout del messaggio: tabella o elenco, applicabile solo a h: messages
14	showDetail Valore booleano che determina se vengono visualizzati i dettagli del messaggio. I valori predefiniti sono false per h: messages, true per h: message
15	showSummary Un valore booleano che determina se vengono visualizzati i riepiloghi dei messaggi. I valori predefiniti sono veri per h: messages, false per h: message
16	tooltip Un valore booleano che determina se i dettagli del messaggio vengono visualizzati in una descrizione comando; il tooltip viene visualizzato solo se showDetail e showSummary sono veri
17	warnClass Classe CSS per messaggi di avviso
18	warnStyle Stile CSS per i messaggi di avviso
19	style Informazioni sullo stile in linea
20	title Un titolo, utilizzato per l'accessibilità, che descrive un elemento. I browser visivi in genere creano suggerimenti per il valore del titolo

Applicazione di esempio

Creiamo un'applicazione JSF di prova per testare il tag precedente.

Passo	Descrizione
1	Creare un progetto con un nome helloworld sotto un pacchetto com.tutorialspoint.test come spiegato nel capitolo JSF - Prima applicazione .
2	Modifica home.xhtml come spiegato di seguito. Mantieni invariato il resto dei file.
3	Compilare ed eseguire l'applicazione per assicurarsi che la logica aziendale funzioni secondo i requisiti.
4	Infine, crea l'applicazione sotto forma di file war e distribuiscila in Apache Tomcat Webserver.
5	Avvia la tua applicazione web utilizzando l'URL appropriato come spiegato di seguito nell'ultimo passaggio.

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>

Una volta che sei pronto con tutte le modifiche apportate, compiliamo ed eseguiamo l'applicazione come abbiamo fatto nel capitolo JSF - Prima applicazione. Se tutto va bene con la tua applicazione, questo produrrà il seguente risultato.