Skip to main content
summaryrefslogtreecommitdiffstats
path: root/jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml
diff options
context:
space:
mode:
Diffstat (limited to 'jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml')
-rw-r--r--jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml1026
1 files changed, 0 insertions, 1026 deletions
diff --git a/jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml b/jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml
deleted file mode 100644
index a9358d923..000000000
--- a/jsf/plugins/org.eclipse.jst.jsf.facelet.core/std-taglibs/ui.taglib.xml
+++ /dev/null
@@ -1,1026 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!--
- DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
-
- Copyright 2009 Sun Microsystems, Inc. All rights reserved.
-
- The contents of this file are subject to the terms of either the GNU
- General Public License Version 2 only ("GPL") or the Common Development
- and Distribution License("CDDL") (collectively, the "License"). You
- may not use this file except in compliance with the License. You can obtain
- a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
- or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific
- language governing permissions and limitations under the License.
-
- When distributing the software, include this License Header Notice in each
- file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
- Sun designates this particular file as subject to the "Classpath" exception
- as provided by Sun in the GPL Version 2 section of the License file that
- accompanied this code. If applicable, add the following below the License
- Header, with the fields enclosed by brackets [] replaced by your own
- identifying information: "Portions Copyrighted [year]
- [name of copyright owner]"
-
- Contributor(s):
-
- If you wish your version of this file to be governed by only the CDDL or
- only the GPL Version 2, indicate your decision by adding "[Contributor]
- elects to include this software in this distribution under the [CDDL or GPL
- Version 2] license." If you don't indicate a single choice of license, a
- recipient has the option to distribute your version of this file under
- either the CDDL, the GPL Version 2 or to extend the choice of license to
- its licensees as provided above. However, if you add GPL Version 2 code
- and therefore, elected the GPL Version 2 license, then the option applies
- only if the new code is made subject to such option by the copyright
- holder.
--->
-
-<facelet-taglib xmlns="http://java.sun.com/xml/ns/javaee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
- version="2.0">
- <description>
-
- &lt;/pre&gt;
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;The tags in this library add templating&amp;#8212;a powerful
- view composition technique&amp;#8212;to JSF.
- Templating is so useful that there are entire frameworks, such as Tiles
- and SiteMesh, that are built
- around the concept of templating. So what is templating, how can you
- benefit from it, and how does
- this tag library implement it?
- &lt;/p&gt;
-
- &lt;p&gt;If you've used JSP before, you've probably used &lt;code&gt;jsp:include&lt;/code&gt;.
- The prototypical example for
- &lt;code&gt;jsp:include&lt;/code&gt; is a header on each page in a web
- application. One JSP page, say header.jsp,
- encapsulates the header content, and the header is included by each
- page. You &lt;em&gt;encapsulate and reuse
- content&lt;/em&gt;, so that changes to one file, header.jsp, affect the
- header on every page.
- &lt;/p&gt;
-
- &lt;p&gt;This tab library contains a tag&amp;#8212&lt;code&gt;ui:include&lt;/code&gt;&amp;#8212
- that's analagous to &lt;code&gt;jsp:include&lt;/code&gt;,
- but encapsulating and reusing content is only half the templating story,
- because templating also lets you
- &lt;em&gt;encapsulate and reuse &lt;b&gt;layout&lt;/b&gt;&lt;/em&gt;.
- You define a single &lt;em&gt;template&lt;/em&gt; (meaning layout), and
- you reuse
- that template with multiple &lt;em&gt;compositions&lt;/em&gt;. So now
- you can control the layout of many pages with a single
- template (layout). Let's take a look at an example.
- &lt;/p&gt;
-
- &lt;h3&gt;A Templating Example&lt;/h3&gt;
-
- &lt;p&gt;
- First, we define a template:
- &lt;/p&gt;
- &lt;div class="syntax"&gt;&lt;div class="html4strict"
- style="font-family: monospace;"&gt;&lt;ol&gt;&lt;li class="li1"&gt;&lt;div
- class="de1"&gt;&lt;span class="sc0"&gt;&amp;lt;!DOCTYPE html PUBLIC
- &amp;quot;-//W3C//DTD XHTML 1.0 Transitional//EN&amp;quot;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &amp;nbsp; &amp;nbsp; &amp;quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&amp;quot;&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="re0"&gt;xmlns&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;http://www.w3.org/1999/xhtml&amp;quot;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &amp;nbsp; xmlns:&lt;span class="re0"&gt;ui&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;http://java.sun.com/jsf/facelets&amp;quot;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;head&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;link&lt;/span&gt;
- &lt;span class="re0"&gt;href&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;styles.css&amp;quot;&lt;/span&gt;
- &lt;span class="re0"&gt;rel&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;stylesheet&amp;quot;&lt;/span&gt;
- &lt;span class="re0"&gt;type&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;text/css&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;title&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:insert
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;title&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;Default Title&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:insert&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;/title&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/head&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:debug&lt;span
- class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;div&lt;/span&gt;
- &lt;span class="re0"&gt;class&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;heading&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:insert
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;heading&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/div&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;div&lt;/span&gt;
- &lt;span class="re0"&gt;class&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;content&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:insert
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;content&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/div&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;/html&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;
- &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/div&gt;&lt;/div&gt;
-
- &lt;p&gt;
- In the preceeding listing, we've defined a layout, also known as a
- template. That template uses the
- &lt;code&gt;ui:insert&lt;/code&gt; tag to insert pieces of a page &amp;#8212namely,
- title, heading, and content&amp;#8212
- defined in a &lt;em&gt;composition&lt;/em&gt;. Notice that on line 8, we
- define a default title, in case one isn't provided
- by the composition. Also note that on line 12 we have the &lt;code&gt;ui:debug&lt;/code&gt;
- tag, which lets the user activate
- a popup window with debugging information by typing CTRL + Shift + d.
- &lt;/p&gt;
-
- &lt;p&gt;
- The title, heading, and content pieces of the page referenced in the
- template are defined in a separate XHTML
- file in a composition, like this:
- &lt;/p&gt;
-
- &lt;div class="syntax"&gt;&lt;div class="html4strict"
- style="font-family: monospace;"&gt;&lt;ol&gt;&lt;li class="li1"&gt;&lt;div
- class="de1"&gt;&lt;span class="sc0"&gt;&amp;lt;!DOCTYPE html PUBLIC
- &amp;quot;-//W3C//DTD XHTML 1.0 Transitional//EN&amp;quot;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&amp;quot;&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="re0"&gt;xmlns&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;http://www.w3.org/1999/xhtml&amp;quot;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;xmlns:&lt;span
- class="re0"&gt;ui&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;http://java.sun.com/jsf/facelets&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:composition
- &lt;span class="re0"&gt;template&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;/layout.xhtml&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;title&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;A List of Contacts&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;heading&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;Contacts&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;content&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:include
- &lt;span class="re0"&gt;src&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;contactsTable.xhtml&amp;quot;&lt;/span&gt;
- &lt;span class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:composition&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;/html&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;
- &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/div&gt;&lt;/div&gt;
-
- &lt;p&gt;
- At runtime, JSF synthesizes the two previous XHTML pages to create a
- single JSF view by inserting the
- pieces defined in the composition into the template (that template is
- layout.xhtml, which is the first
- listing above). JSF also disregards everything outside of the &lt;code&gt;composition&lt;/code&gt;
- tag so that we don't
- wind up with two &lt;code&gt;body&lt;/code&gt; elements in the view.
- Also, note that we use the &lt;code&gt;ui:include&lt;/code&gt;
- tag on line 14 to include content (which happens to be a table) from
- another XHTML page, so that we can reuse
- that table in other views.
- &lt;/p&gt;
-
- &lt;p&gt;
- So why do we have two XHTML pages to define a single view? Why not
- simply take the pieces and manually insert
- them into the layout so that we have only a single XHTML page? The
- answer is simple: we have separated layout
- from the content so that we can &lt;em&gt;reuse that layout&lt;/em&gt;
- among multiple compositions. For example, now we can
- define another composition that uses the same layout:
- &lt;/p&gt;
-
- &lt;div class="syntax"&gt;&lt;div class="html4strict"
- style="font-family: monospace;"&gt;&lt;ol&gt;&lt;li class="li1"&gt;&lt;div
- class="de1"&gt;&lt;span class="sc0"&gt;&amp;lt;!DOCTYPE html PUBLIC
- &amp;quot;-//W3C//DTD XHTML 1.0 Transitional//EN&amp;quot;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&amp;quot;&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="re0"&gt;xmlns&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;http://www.w3.org/1999/xhtml&amp;quot;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- xmlns:&lt;span class="re0"&gt;ui&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;http://java.sun.com/jsf/facelets&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:composition
- &lt;span class="re0"&gt;template&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;/layout.xhtml&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;title&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;Create a Contact&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;heading&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;Create Contact&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;content&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:include
- &lt;span class="re0"&gt;src&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;createContactForm.xhtml&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:composition&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/body&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;/html&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;
- &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/div&gt;&lt;/div&gt;
-
- &lt;p&gt;
- By encapsulating the layout, we can reuse that layout among multiple
- compositions. Just like
- &lt;code&gt;ui:include&lt;/code&gt; lets us encapsulate and reuse
- conent, JSF compositions let us encapsulate and reuse
- layout, so that changes to a single layout can affect multiple views.
- Fundamentally, that's what this
- tag library is all about.
- &lt;/p&gt;
-
- &lt;/div&gt;
- &lt;pre&gt;
-
- </description>
- <namespace>http://java.sun.com/jsf/facelets</namespace>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- This tag is the same as the &lt;code&gt;ui:composition&lt;/code&gt;,
- except for two things:
- JSF creates a component and adds it directly to the tree, and
- there's no associated
- template.
- &lt;/p&gt;
-
- &lt;p&gt;
- Use this tag to create a component and specify a filename for the
- component as either the source of a &lt;code&gt;ui:include&lt;/code&gt;,
- or the source of a Facelets tag.
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>component</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.ComponentRefHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- The identifier of the component that JSF inserts into the
- component tree. If an identifier is
- not explicitly specified by the page author, JSF will assign an
- identifier based on the algorithm
- that it uses for all components.
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <name>id</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- Binds the component to a backing bean property, as specified in
- the JSF specification.
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <name>binding</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- Defines a composition that optionally uses a template, as outlined
- in the description of the ui tag library. Multiple
- compositions can use the same template, thus encapsulating and
- reusing layout. JSF disregards everything outside of the
- composition, which lets developers embed compositions in well-formed
- XHTML pages that can be viewed in an XHTML viewer,
- such as Dreamweaver or a browser, without including extraneous
- elements such as &lt;code&gt;head&lt;/code&gt; and &lt;code&gt;body&lt;/code&gt;.
- &lt;/p&gt;
- &lt;div class="syntax"&gt;&lt;div class="html4strict"
- style="font-family: monospace;"&gt;&lt;ol&gt;&lt;li class="li1"&gt;&lt;div
- class="de1"&gt;&lt;span class="sc0"&gt;&amp;lt;!DOCTYPE html PUBLIC
- &amp;quot;-//W3C//DTD XHTML 1.0 Transitional//EN&amp;quot;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &amp;quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&amp;quot;&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;html&lt;/span&gt; &lt;span class="re0"&gt;xmlns&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;http://www.w3.org/1999/xhtml&amp;quot;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;xmlns:&lt;span
- class="re0"&gt;ui&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;http://java.sun.com/jsf/facelets&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;body&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- THIS LINE, AND EVERYTHING ABOVE IT IS DISREGARDED BY JSF&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:composition
- &lt;span class="re0"&gt;template&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;/layout.xhtml&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;title&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;#{msgs.contactsWindowTitle}&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;heading&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;#{msgs.contactsHeading}&lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:define
- &lt;span class="re0"&gt;name&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;content&amp;quot;&lt;/span&gt;&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;ui&lt;/span&gt;:include
- &lt;span class="re0"&gt;src&lt;/span&gt;=&lt;span class="st0"&gt;&amp;quot;contactsTable.xhtml&amp;quot;&lt;/span&gt;
- &lt;span class="re2"&gt;/&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:define&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &lt;span class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/ui&lt;/span&gt;:composition&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &amp;nbsp;
- THIS LINE, AND EVERYTHING BELOW IT IS DISREGARDED BY JSF&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc3"&gt;&lt;span class="re1"&gt;&amp;lt;/body&lt;span
- class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&lt;span class="sc3"&gt;&lt;span
- class="re1"&gt;&amp;lt;/html&lt;span class="re2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;
- &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/div&gt;&lt;/div&gt;
-
- &lt;/div&gt;
-
- </description>
- <tag-name>composition</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.CompositionHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- A URI that points to a template, also known as a layout, that
- inserts pieces of the page defined in the composition.
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <name>template</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- When the &lt;code&gt;ui:debug&lt;/code&gt; tag is placed in an XHTML
- page, it creates a component and adds it to the
- component tree. That debug component captures debugging information,
- namely the current state of the component
- tree and the scoped variables in the application, when the component
- is rendered. If the user presses CTRL + SHIFT + d,
- JSF opens a window that shows the debugging information captured by
- the debug component.
- &lt;/p&gt;
-
- &lt;p&gt;
- Typically, the best place to put the &lt;code&gt;ui:debug&lt;/code&gt;
- tag is in an application's main template, which
- lets developers enable or disable viewing of debugging information
- in one central location. Additionally, page
- authors can change the hotkey (which by default is CTRL + SHIFT + d,
- where the d stands for debug) to CTRL + SHIFT + ?,
- where ? represents the key specified as the value of the &lt;code&gt;hotkey&lt;/code&gt;
- attribute.
- &lt;/p&gt;
-
- &lt;p&gt;
- You can use the &lt;code&gt;rendered&lt;/code&gt; attribute to
- control whether the debug component is rendered.
- Using an EL expression as the value for the &lt;code&gt;rendered&lt;/code&gt;
- attribute lets you control whether
- debug output is enabled for multiple views based on a single bean
- property.
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>debug</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.UIDebug</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- Defines a single character, that, pressed in conjunction with
- CTRL and SHIFT, will display the JSF debug window.
- By default, the hotkey is 'd'. &lt;em&gt;The value for the
- hotkey attribute cannot be an EL expression.&lt;/em&gt;
- &lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>hotkey</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;
- Controls whether the debug component is rendered. Valid values
- for this attribute are either the strings "true" or "false" or
- an EL expression that evaluates to either "true" or "false".&lt;p&gt;If
- this attribute's value is "false" or the value is an EL
- expression that evaluates to "false", the debug component is not
- rendered in the page, the hotkey attribute is disregarded, and
- users cannot open the debugging information window with a
- hotkey.&lt;/p&gt;
- &lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>rendered</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;The &lt;code&gt;define&lt;/code&gt; tag defines content
- that is inserted into a page by a template. The &lt;code&gt;define&lt;/code&gt;
- tag can be used inside &lt;code&gt;ui:composition&lt;/code&gt;, &lt;code&gt;ui:component&lt;/code&gt;,
- &lt;code&gt;ui:decorate&lt;/code&gt;, and &lt;code&gt;ui:fragment&lt;/code&gt;
- tags.&lt;/p&gt;
-
- &lt;p&gt;Content defined by the &lt;code&gt;define&lt;/code&gt; tag
- can be inserted into a page by using &lt;code&gt;ui:insert&lt;/code&gt;.
- &lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <tag-name>define</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.DefineHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;Assigns a name to the content inside a &lt;code&gt;define&lt;/code&gt;
- tag. That name is used by corresponding &lt;code&gt;ui:insert&lt;/code&gt;
- tags in a template that insert the named content into a page.&lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <name>name</name>
- <required>true</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;
- The &lt;code&gt;decorate&lt;/code&gt; tag is identical to the &lt;code&gt;composition&lt;/code&gt;
- tag, except that &lt;code&gt;ui:decorate&lt;/code&gt;, unlike &lt;code&gt;ui:composition&lt;/code&gt;,
- does not disregard all content outside of the tag. The &lt;code&gt;decorate&lt;/code&gt;
- is useful when you want to decorate some content in a page, for
- example, you might want to decorate a list of items, like this:
-
- &lt;div class="syntax"&gt;&lt;div class="html4strict"
- style="font-family: monospace;"&gt;&lt;ol&gt;&lt;li class="li1"&gt;&lt;div
- class="de1"&gt;
-
- &lt;span class="sc2"&gt;&amp;lt;ui:decorate template=&lt;span
- class="st0"&gt;&amp;quot;/layout.xhtml&amp;quot;&lt;/span&gt;&lt;span
- class="kw2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc2"&gt;&amp;lt;ui:define &lt;span class="kw3"&gt;name&lt;/span&gt;=&lt;span
- class="st0"&gt;&amp;quot;listHeading&amp;quot;&lt;/span&gt;&lt;span
- class="kw2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &lt;span class="sc2"&gt;&amp;lt;ui:include &lt;span class="kw3"&gt;src&lt;/span&gt;="shared/listHeading.xhtml"/&lt;span
- class="kw2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc2"&gt;&lt;span class="kw2"&gt;&amp;lt;&lt;/span&gt;/ui:define&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- &amp;nbsp; &amp;nbsp; &lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc2"&gt;&amp;lt;c:forEach items="#&lt;span class="br0"&gt;&amp;#123;&lt;/span&gt;items&lt;span
- class="br0"&gt;&amp;#125;"&lt;/span&gt; var="item"&lt;span
- class="kw2"&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
-
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; &amp;nbsp;
- ...&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&amp;nbsp; &lt;span
- class="sc2"&gt;&lt;span class="kw2"&gt;&amp;lt;&lt;/span&gt;/c:forEach&amp;gt;&lt;/span&gt;&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li1"&gt;&lt;div class="de1"&gt;&amp;nbsp; ...&lt;/div&gt;&lt;/li&gt;
- &lt;li class="li2"&gt;&lt;div class="de2"&gt;&lt;span class="sc2"&gt;&lt;span
- class="kw2"&gt;&amp;lt;&lt;/span&gt;/ui:decorate&amp;gt;&lt;/span&gt;
- &lt;/div&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/div&gt;&lt;/div&gt;
- &lt;/p&gt;
-
- Because JSF does not disregard everything outside of the &lt;code&gt;ui:decorate&lt;/code&gt;
- tag, &lt;code&gt;ui:decorate&lt;/code&gt; can
- be used to decorate pieces of a page.
-
- &lt;/div&gt;
-
- </description>
- <tag-name>decorate</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.DecorateHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- A URI that points to a template, also known as a layout, that
- inserts pieces of the page defined in the decorator.
-
- &lt;/div&gt;
-
- </description>
- <name>template</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;The &lt;code&gt;fragment&lt;/code&gt; tag is identical to
- the &lt;code&gt;component&lt;/code&gt; tag, except that &lt;code&gt;ui:fragment&lt;/code&gt;,
- unlike &lt;code&gt;ui:component&lt;/code&gt;, JSF does not disregard
- all content outside of the tag.&lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>fragment</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.ComponentRefHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- The identifier of the component that JSF inserts into the
- component tree. If an identifier is
- not explicitly specified by the page author, JSF will assign an
- identifier based on the algorithm
- that it uses for all components.
- &lt;/div&gt;
-
- </description>
- <name>id</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- Binds the component to a backing bean property, as specified in
- the JSF specification.
- &lt;/div&gt;
-
- </description>
- <name>binding</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;Use this tag&amp;#8212which is very similar to JSP's &lt;code&gt;jsp:include&lt;/code&gt;&amp;#8212to
- encapsulate and reuse content among
- multiple XHTML pages. There are three things this tag can include:
- plain XHTML, and XHTML pages that have either a &lt;code&gt;composition&lt;/code&gt;
- tag or a &lt;code&gt;component&lt;/code&gt; tag.
- &lt;/p&gt;
- &lt;p&gt;You supply a filename, through &lt;code&gt;ui:include&lt;/code&gt;'s
- &lt;code&gt;src&lt;/code&gt; attribute for JSF to include. That
- filename is relative to the XHTML file that was rendered as a result
- of the last request. So, for example, if JSF loaded
- the view &lt;code&gt;login.xhtml&lt;/code&gt;, and that file
- included &lt;code&gt;pageDecorations/header.xhtml&lt;/code&gt;, and
- &lt;code&gt;
- pageDecorations/header.xhtml&lt;/code&gt; included &lt;code&gt;companyLogo.xhtml&lt;/code&gt;,
- then &lt;code&gt;companyLogo.xhtml&lt;/code&gt; will
- not be found if it's in the &lt;code&gt;pageDecorations&lt;/code&gt;
- directory, because &lt;code&gt;companyLogo.xhtml&lt;/code&gt; has to
- be
- in the same directory as &lt;code&gt;login.xhtml&lt;/code&gt;.
- &lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <tag-name>include</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.IncludeHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- The filename of an XHTML page to include. The filename is
- relative to the XHTML page that was originally loaded.
- &lt;/div&gt;
-
- </description>
- <name>src</name>
- <required>true</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;Inserts content into a template. That content is defined&amp;#8212with
- the &lt;code&gt;ui:define&lt;/code&gt; tag&amp;#8212 in either a
- &lt;code&gt;ui:composition&lt;/code&gt;, &lt;code&gt;ui:component&lt;/code&gt;,
- &lt;code&gt;ui:decorate&lt;/code&gt;, or &lt;code&gt;ui:fragment&lt;/code&gt;.&lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>insert</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.IncludeHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- The optional name attribute matches the associated &amp;lt;ui:define/&amp;gt;
- tag in this template's client. If no name is specified, it's
- expected
- that the whole template client will be inserted.
-
- &lt;/div&gt;
-
- </description>
- <name>name</name>
- <required>false</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;Use this tag to pass parameters to an included file (using
- &lt;code&gt;ui:include&lt;/code&gt;), or a template
- (linked to either a composition or decorator). Embed &lt;code&gt;ui:param&lt;/code&gt;
- tags in either &lt;code&gt;ui:include&lt;/code&gt;,
- &lt;code&gt;ui:composition&lt;/code&gt;, or &lt;code&gt;ui:decorate&lt;/code&gt;
- to pass the parameters.
- &lt;/div&gt;
-
- </description>
- <tag-name>param</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.ParamHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- The name of the parameter.
- &lt;/div&gt;
-
- </description>
- <name>name</name>
- <required>true</required>
- <type>java.lang.String</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- The value of the parameter. Notice that this attribute's value
- can be an EL expression, which
- means that you can pass objects to either an included file or a
- template.
- &lt;/div&gt;
- </description>
- <name>value</name>
- <required>true</required>
- <type>java.lang.String</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;Use this tag as an alternative to &lt;code&gt;h:dataTable&lt;/code&gt;
- or
- &lt;code&gt;c:forEach&lt;/code&gt;, especially when you are using
- the
- &lt;code&gt;jsfc&lt;/code&gt; feature of Facelets. You can specify
- this component as
- the value of the &lt;code&gt;jsfc&lt;/code&gt; attribute, like this:
- &amp;lt;div... jsfc="ui:repeat" value="#{contacts}" var="contact"&amp;gt;...
- &lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>repeat</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.RepeatHandler</handler-class>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;Read-write property setting the offset from the
- beginning of the
- collection from which to start the iteration. If not set, this
- offset
- is not considered and iteration will start at the beginning of
- the
- collection.&lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>offset</name>
- <required>false</required>
- <type>int</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;Read-write property setting the size of the collection
- to iterate.
- If this value is less than the actual size of the collection, a
- &lt;code&gt;FacesException&lt;/code&gt; must be thrown.&lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>size</name>
- <required>false</required>
- <type>int</type>
- </attribute>
- <attribute>
- <description>
-
- &lt;div class="changed_added_2_0"&gt;&lt;p&gt;Iteration
- will only process every step items of the collection,
- starting with the first one.&lt;/p&gt;&lt;/div&gt;
-
- </description>
- <name>step</name>
- <required>false</required>
- <type>int</type>
- </attribute>
- <attribute>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
-
- &lt;p&gt;The name of a collection of items that this tag
- iterates over. The
- collection may be a &lt;code&gt;List&lt;/code&gt;, &lt;code&gt;array&lt;/code&gt;,
- &lt;code&gt;java.sql.ResultSet&lt;/code&gt;, or an individual
- java Object. If the
- collection is null, this tag does nothing.&lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>value</name>
- <required>true</required>
- <type>java.lang.Object</type>
- </attribute>
- <attribute>
- <description>
-
- &lt;div class="changed_added_2_0"&gt;&lt;p&gt;Name of the
- exported scoped variable for the current item of the
- iteration. This scoped variable has nested
- visibility. Its type depends on the object of the
- underlying collection&lt;/p&gt;&lt;/div&gt;
-
- </description>
- <name>var</name>
- <required>true</required>
- <type>java.lang.Object</type>
- </attribute>
- <attribute>
- <description>
-
- &lt;div class="changed_added_2_0"&gt;&lt;p&gt;Name of the
- exported request scoped variable for the status of the
- iteration. Object is a POJO with the following read-only
- JavaBeans properties. This scoped variable has nested
- visibility.&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;begin&lt;/code&gt; of type Integer&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;end&lt;/code&gt; of type Integer&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;index&lt;/code&gt; of type int&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;step&lt;/code&gt; of type Integer&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;even&lt;/code&gt; of type boolean&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;odd&lt;/code&gt; of type boolean&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;first&lt;/code&gt; of type boolean&lt;/p&gt;
-
- &lt;p&gt;&lt;code&gt;last&lt;/code&gt; of type boolean&lt;/p&gt;
-
- &lt;/div&gt;
-
- </description>
- <name>varStatus</name>
- <required>false</required>
- <type>java.lang.Object</type>
- </attribute>
- </tag>
- <tag>
- <description>
-
-
- &lt;div class="changed_added_2_0"&gt;
- &lt;p&gt;Remove content from a page. This tag is often used in
- conjunction with the &lt;code&gt;jsfc&lt;/code&gt; feature of
- Facelets,
- to wrap additional markup. When Facelets removes markup from a page
- by substituting markup items that have
- a &lt;code&gt;jsfc&lt;/code&gt; attribute with the specified
- component, Facelets also removes anything in the page that
- is contained in a &lt;code&gt;ui:remove&lt;/code&gt; tag.&lt;/p&gt;
- &lt;/div&gt;
-
- </description>
- <tag-name>remove</tag-name>
- <handler-class>com.sun.faces.facelets.tag.ui.SchemaCompliantRemoveHandler</handler-class>
-
- </tag>
-</facelet-taglib>

Back to the top