Developing Web 2.0 applications
with JavaServerFaces
and Dreamweaver
>> Just Became Easier
Documentation
Search
  1. Introduction
  2. Getting Started
  3. Facelets Concepts
  4. Document Types
  5. Design View
  6. Code View Support
  7. Keyboard Shortcuts
  8. Tag Object Toolbars
  9. Property Inspectors
  10. Facelets Tag Reference
Facelets UI Tag Library
  ui:component
  ui:composition
  ui:debug
  ui:decorate
  ui:define
  ui:fragment
  ui:include
Selected ui:insert
  ui:param
  ui:remove
  ui:repeat
If you like this documentation, please take a look at my book:

10. Facelets UI Tag Reference

Documentation > Facelets > Facelets Tag Reference > Facelets UI Tag Library > ui:insert

ui:insert

The UI Insert tag is a templating tag that declares a named content element to be defined by another Facelet. It can be used effectively with the ui:define tag to pass values between Facelets.

Facelets Template (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>
<title><ui:insert name="title" /></title>
</h:head>
<body>
<h2><ui:insert name="header" /></h2>
<ui:insert name="message" />
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.

Facelets Template Client (client.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:ui="http://java.sun.com/jsf/facelets">
<h:head />
<body>
<ui:composition template="template.xhtml">
  <ui:define name="title">Welcome</ui:define>
  <ui:define name="header">Hello World</ui:define>
  <ui:define name="message">How are you today?</ui:define>
</ui:composition>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.

HTML Output

<html>
  <head>
    <title>Welcome</title>
  </head>
  <body>
    <h2>Hello World!</h2>
    How are you today?
  </body>
</html>

Tag Attributes

name Text
 
The name attribute specifies the name of the matching ui:define tag that will provide the content to be inserted into this Facelet.