JSF - ui: balise param

En utilisant la balise ui: param , nous pouvons passer des paramètres au fichier modèle ou à un fichier inclus.

Dans JSF - chapitre sur les balises de gabarit , nous avons appris comment créer et utiliser des balises de gabarit. Nous avons défini diverses sections telles que l'en-tête, le pied de page, le contenu et un modèle combinant toutes les sections.

Maintenant, nous allons apprendre -

Comment passer des paramètres à diverses sections d'un modèle
Comment passer des paramètres à un modèle

Paramètre de section d'un modèle

Créer un paramètre: common.xhtml

Ajouter un paramètre à ui: inclure la balise. Utilisationui:param balise pour définir un paramètre contenant une valeur à transmettre à la section Header.

<ui:insert name = "header" >
   <ui:include src = "/templates/header.xhtml" >
      <ui:param name = "defaultHeader" value = "Default Header" />
   </ui:include>
</ui:insert>

Utilisez le paramètre: header.xhtml

<ui:composition> 		
   <h1>#{defaultHeader}</h1>
</ui:composition>

Paramètre vers modèle

Créer un paramètre: home.xhtml

Ajouter un paramètre à ui: balise de composition. Utilisationui:param balise pour définir un paramètre contenant une valeur à transmettre au modèle.

<ui:composition template = "templates/common.xhtml">	
   <ui:param name = "title" value = "Home" />
</ui:composition>

Utiliser le paramètre: common.xhtml

<h:body> 
   <h2>#{title}</h2>
</h:body>

Exemple d'application

Créons une application de test JSF pour tester les balises de modèle dans JSF.

Étape	La description
1	Créez un projet avec un nom helloworld sous un package com.tutorialspoint.test comme expliqué dans le chapitre JSF - Templates Tag .
2	Modifier header.xhtml et common.xhtml fichiers sous src → → webapp principal → Modèles dossier. Modifiez-les comme expliqué ci-dessous.
3	Modifiez home.xhtml comme expliqué ci-dessous. Gardez le reste des fichiers inchangé.
4	Compilez et exécutez l'application pour vous assurer que la logique métier fonctionne conformément aux exigences.
5	Enfin, créez l'application sous la forme d'un fichier war et déployez-la dans Apache Tomcat Webserver.
6	Lancez votre application Web en utilisant l'URL appropriée, comme expliqué ci-dessous à la dernière étape.

header.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!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"   
   xmlns:ui = "http://java.sun.com/jsf/facelets">
   
   <body>
      <ui:composition> 
         <h1>#{defaultHeader}</h1>
      </ui:composition>	
   </body>
</html>

common.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!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"   
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:ui = "http://java.sun.com/jsf/facelets"> 
   
   <h:head></h:head>
   <h:body>
      <h2>#{title}</h2>
      
      <div style = "border-width:2px; border-color:green; border-style:solid;">
         <ui:insert name = "header" >
            <ui:include src = "/templates/header.xhtml" >
               <ui:param name = "defaultHeader" value = "Default Header" />
            </ui:include>
         </ui:insert> 
      </div>
      <br/>
      
      <div style = "border-width:2px; border-color:black; border-style:solid;">
         <ui:insert name = "content" >
            <ui:include src = "/templates/contents.xhtml" />
         </ui:insert>    
      </div>
      <br/>
      
      <div style = "border-width:2px; border-color:red; border-style:solid;">
         <ui:insert name = "footer" >
            <ui:include src = "/templates/footer.xhtml" />
         </ui:insert>
      </div>
   
   </h:body>
</html>

home.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!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"   
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:ui = "http://java.sun.com/jsf/facelets">
   
   <h:body>
      <ui:composition template = "templates/common.xhtml">
         <ui:param name = "title" value = "Home" />
         
         <ui:define name = "content">				
            <br/><br/>
             <h:link value = "Page 1" outcome = "page1" />
             <h:link value = "Page 2" outcome = "page2" />			
            <br/><br/>
         </ui:define>
      </ui:composition>
   </h:body>
</html>

Une fois que vous êtes prêt avec tous les changements effectués, laissez-nous compiler et exécuter l'application comme nous l'avons fait dans le chapitre JSF - Première application. Si tout va bien avec votre application, cela produira le résultat suivant.

↰ Previous page