|
The UI Decorate tag is a templating tag that decorates content included from
another Facelet. Any content outside of the UI Decorate tag will be displayed by
the Facelets view handler. Any content within the decorate tag will be passed to
the associated template as parameters or simply ignored. You can use nested ui:define tags to pass named
content to the associated template. See ui:insert for more
information.
Templating Tip:
The content of the page containing the decorate tag is be used to populate
an associated template page. If the decorate tag contains ui:define tags, the content
of these tags will be inserted into the template where matching ui:insert tags can be found.
You can use a nameless ui:insert tag to insert all the content of the
composition tag within the template page.
decorate.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"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:ui="http://java.sun.com/jsf/facelets">
<h:head />
<body>
<h:form>
Text before will stay.
<ui:decorate template="decorate-template.xhtml">
<ui:define name="title">Our Products</ui:define>
<ui:define name="body">
<ul>
<li>Apples</li>
<li>Oranges</li>
<li>Bananas</li>
</ul>
</ui:define>
</ui:decorate>
Text after will stay.
</h:form>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.
decorate-template.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"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:ui="http://java.sun.com/jsf/facelets">
<h:head />
<body>
<h:form>
This text will be removed.
<ui:composition>
<h2>
<ui:insert name="title" />
</h2>
<ui:insert name="body" />
</ui:composition>
This text will be removed.
</h:form>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.
Rendered Output
HTML Output
Text before will stay.
<h2>Our Products</h2>
<ul>
<li>Apples</li>
<li>Oranges</li>
<li>Bananas</li>
</ul>
Text after will stay.
|
