| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd"> |
| <!--NewPage--> |
| <HTML> |
| <HEAD> |
| <!-- Generated by javadoc on Fri Aug 22 03:43:56 EDT 2003 --> |
| <TITLE> |
| org.apache.struts.taglib.template (Apache Struts API Documentation) |
| </TITLE> |
| <META NAME="keywords" CONTENT="org.apache.struts.taglib.template package"> |
| <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style"> |
| </HEAD> |
| <SCRIPT> |
| function asd() |
| { |
| parent.document.title="org.apache.struts.taglib.template (Apache Struts API Documentation)"; |
| } |
| </SCRIPT> |
| <BODY BGCOLOR="white" onload="asd();"> |
| |
| <!-- ========== START OF NAVBAR ========== --> |
| <A NAME="navbar_top"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"> |
| <TR> |
| <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> |
| <A NAME="navbar_top_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> |
| <TR ALIGN="center" VALIGN="top"> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> |
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> |
| </TR> |
| </TABLE> |
| </TD> |
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> |
| </EM> |
| </TD> |
| </TR> |
| |
| <TR> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../../../../org/apache/struts/taglib/nested/logic/package-summary.html"><B>PREV PACKAGE</B></A> |
| <A HREF="../../../../../org/apache/struts/taglib/template/util/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A> |
| <A HREF="package-summary.html" TARGET="_top"><B>NO FRAMES</B></A> |
| |
| <SCRIPT> |
| <!-- |
| if(window==top) { |
| document.writeln('<A HREF="../../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); |
| } |
| //--> |
| </SCRIPT> |
| <NOSCRIPT> |
| <A HREF="../../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A> |
| </NOSCRIPT> |
| </FONT></TD> |
| </TR> |
| </TABLE> |
| <!-- =========== END OF NAVBAR =========== --> |
| |
| <HR> |
| <H2> |
| Package org.apache.struts.taglib.template |
| </H2> |
| |
| <b>Note:</b> As of Struts 1.1 the template tag library is |
| deprecated in favor of Tiles. |
| <P> |
| <B>See:</B> |
| <BR> |
| <A HREF="#package_description"><B>Description</B></A> |
| <P> |
| |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"> |
| <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> |
| <TD COLSPAN=2><FONT SIZE="+2"> |
| <B>Class Summary</B></FONT></TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD WIDTH="15%"><B><A HREF="GetTag.html">GetTag</A></B></TD> |
| <TD><B>Deprecated.</B> <I>Use Tiles instead.</I></TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD WIDTH="15%"><B><A HREF="InsertTag.html">InsertTag</A></B></TD> |
| <TD><B>Deprecated.</B> <I>Use Tiles instead.</I></TD> |
| </TR> |
| <TR BGCOLOR="white" CLASS="TableRowColor"> |
| <TD WIDTH="15%"><B><A HREF="PutTag.html">PutTag</A></B></TD> |
| <TD><B>Deprecated.</B> <I>Use Tiles instead.</I></TD> |
| </TR> |
| </TABLE> |
| |
| |
| <P> |
| <A NAME="package_description"><!-- --></A><H2> |
| Package org.apache.struts.taglib.template Description |
| </H2> |
| |
| <P> |
| <p> |
| <b>Note:</b> As of Struts 1.1 the template tag library is |
| deprecated in favor of Tiles. |
| </p> |
| <p> The "struts-template" tag library contains tags that are useful in |
| creating dynamic JSP templates for pages which share a common format. |
| These templates are best used when it is likely that a layout shared |
| by several pages in your application will change. The functionality provided |
| by these tags is similar to what can be achieved using standard JSP include |
| directive, but are dynamic rather than static. </p> |
| <a name="doc.Description"></a> |
| |
| <p> </p> |
| <div align="Center"> <a href="#doc.Introduction">[Introduction]</a> |
| <a href="#doc.Functionality">[Template Functionality]</a> |
| <a href="#TagLib_Template_UML_">[Template UML]</a> |
| <a href="#doc.Properties">[Template Properties]</a> |
| <a href="#doc.Examples">[Template Examples]</a> |
| </div> |
| |
| <p></p> |
| |
| <hr /=""> <a name="doc.Intro"></a> |
| |
| <h3>Introduction<a name="doc.Introduction"></a> |
| </h3> |
| |
| <p> The Template library supplies tags that are useful for creating dynamic |
| JSP templates for pages which share a common format. </p> |
| <a name="doc.Functionality"></a> |
| |
| <h3>Template Tag Functionality<a name="doc.Functionality"></a> |
| </h3> |
| |
| <p>Each of the three template tags has a specific, interelated function:</p> |
| |
| <p> </p> |
| <ul> |
| <li><b><a href="../../../../../../userGuide/struts-template.html#get">get</a> |
| </b> - Retrieves content from a request scope bean, for use in the template |
| layout.</li> |
| <li><b><a href="../../../../../../userGuide/struts-template.html#insert">insert</a> |
| </b> - Retrieves (or includes) the specified template file, and then |
| inserts the specified content into the template's layout. By changing the |
| layout defined in the template file, any other file that inserts the template |
| will automatically use the new layout.</li> |
| <li><b><a href="../../../../../../userGuide/struts-template.html#put">put</a> |
| </b> - Creates a request scope bean that specifies the content to be |
| used by the get tag. Content can be printed directly or included from a JSP |
| or HTML fil</li> |
| <li><br> |
| <br> |
| <br> |
| </li> |
| <li><a name="TagLib_Template_UML_"></a> |
| <img src="doc-files/template.gif" alt="TagLib Template UML"> |
| </li> |
| |
| </ul> |
| |
| <p></p> |
| |
| <h3>Template Tag Properties<a name="doc.Properties"></a> |
| </h3> |
| |
| <p>The three template tags use very simple attributes :</p> |
| |
| <blockquote> |
| <p><b>get</b> - Requires a single property, the name of the content to |
| be inserted. This tag is used in the template file to indicate where in the |
| layout to insert the content. This name matches the name property used by |
| a put tag.</p> |
| |
| <p><b>insert</b> - Requires a single property, the name of the template. |
| This tag is the parent to one or more put tags. The put tags indicate the |
| content to be inserted into the template. The layout of the content is determined |
| by get tags placed in the template.</p> |
| |
| <p><b>put</b> - Requires a name property, which should match a name used |
| in the template file. The content property indicates the source of the content. |
| The optional direct attribute indicates whether the content should be included |
| or printed directly (as a literal string). The default is false, meaning |
| content is included.</p> |
| <a name="doc.Examples"></a> |
| |
| <h3>Template Tag Examples</h3> |
| |
| <p align="Center"><b>A sample template file</b></p> |
| |
| <blockquote> |
| <hr> |
| <pre><%@ taglib uri='/WEB-INF/tlds/struts-template.tld' prefix='template' %><br><html><head><title><template:get name='title'/></title></head><br><body background='graphics/blueAndWhiteBackground.gif'><br><table><br> <tr valign='top'><td><template:get name='sidebar'/></td><br> <td><table><br> <tr><td><template:get name='header'/></td></tr><br> <tr><td><template:get name='content'/></td></tr><br> <tr><td><template:get name='footer'/></td></tr><br> </table><br> </td><br> </tr><br></table><br></body></html><br><%<br>/*<br>"chapterTemplate.jsp"<br>Display a "sidebar" in a column along the left side of the page.<br>Display a "header" over the right column.<br>Display the page "content" below the header.<br>Display a "footer" at below the content.<br>If we change the layout of the elements on this page, all pages<br>inserting this page will also change to use the new layout.<br>*/<br>%><br></pre> |
| |
| <hr> </blockquote> |
| |
| <p align="Center"><b>A sample JSP using the template</b></p> |
| |
| <blockquote> |
| <hr> |
| <pre><%@ taglib uri='/WEB-INF/tlds/struts-template.tld' prefix='template' %><br><template:insert template='/chapterTemplate.jsp'><br> <template:put name='title' content='Templates' direct='true'/><br> <template:put name='header' content='/header.html' /><br> <template:put name='sidebar' content='/sidebar.jsp' /><br> <template:put name='content' content='/introduction.html'/><br> <template:put name='footer' content='/footer.html' /><br></template:insert><br><%<br>/*<br>"introduction.jsp"<br>Specify template for this page (chapterTemplate.jsp).<br>The chapterTemplate.jsp defines the layout positions for five<br>elements: title, header, sidebar, content, and footer.<br>Specify the source file (html or jsp) for each element.<br>*/<br>%><br></pre> |
| |
| <hr> </blockquote> |
| |
| <p align="Center"><b>A sample HTML content file ("header.html") used |
| by "introduction.jsp", and others.</b></p> |
| |
| <blockquote> |
| <hr> |
| <pre><table><br><tr><br><td><img src='graphics/java.gif'/></td><br><td><img src='graphics/templates.gif'/></td><br></tr><br></table><br></pre> |
| |
| <hr> </blockquote> |
| |
| <p align="Center"><b>A sample JSP content file ("sidebar.jsp") used |
| by "introduction.jsp", and others.</b></p> |
| |
| <blockquote> |
| <hr> |
| <pre><font size='5'><a name="top">Topics</a></font><p><br><table width='145'><br> <tr><td><a href='introduction.jsp'><br> Introduction </a></td></tr><br> |
| <tr><td><a href='using.jsp'><br> Using Templates </a></td></tr><br> |
| <tr><td><a href='optional.jsp'><br> Optional Content </a></td></tr><br> <tr><td><a href='more.jsp'><br> ... and more ...</a></td></tr><br> </table></p><br> |
| <%<br>/*<br>Specify navigational links for this application.<br>*/<br>%><br></pre> |
| |
| <hr> </blockquote> |
| |
| <p align="Center"><b>A sample HTML content file used by "introduction.jsp" |
| only.</b></p> |
| |
| <blockquote> |
| <hr> |
| <pre><html><br><head><br><link rel="stylesheet" href="css/templates.css" <br>charset="ISO-8859-1" type="text/css"><br></head><br><body><br><h3 class="ChapTitle">Introduction</h3><br><p class="Paragraph">Window toolkits typically provide a layout mechanism<br>< ... /><br><hr> |
| </pre> |
| </blockquote> |
| <!-- |
| <h3>Optional Content</h3> |
| <p>All content is optional. If a source page does not specify the content for an element in the template, that element is simply ignored. This can make using templates more flexible, since you can use the same template for more than one page, simply by ommitting or specifying a content element. However, this feature also means that a misspelled name could lead the template to quietly ignore content you meant to include.</p> |
| --> |
| </blockquote> |
| <P> |
| |
| <P> |
| <HR> |
| |
| <!-- ========== START OF NAVBAR ========== --> |
| <A NAME="navbar_bottom"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"> |
| <TR> |
| <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> |
| <A NAME="navbar_bottom_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> |
| <TR ALIGN="center" VALIGN="top"> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> |
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> |
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> |
| </TR> |
| </TABLE> |
| </TD> |
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> |
| </EM> |
| </TD> |
| </TR> |
| |
| <TR> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../../../../org/apache/struts/taglib/nested/logic/package-summary.html"><B>PREV PACKAGE</B></A> |
| <A HREF="../../../../../org/apache/struts/taglib/template/util/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD> |
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> |
| <A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A> |
| <A HREF="package-summary.html" TARGET="_top"><B>NO FRAMES</B></A> |
| |
| <SCRIPT> |
| <!-- |
| if(window==top) { |
| document.writeln('<A HREF="../../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); |
| } |
| //--> |
| </SCRIPT> |
| <NOSCRIPT> |
| <A HREF="../../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A> |
| </NOSCRIPT> |
| </FONT></TD> |
| </TR> |
| </TABLE> |
| <!-- =========== END OF NAVBAR =========== --> |
| |
| <HR> |
| Copyright © 2000-2003 - Apache Software Foundation |
| </BODY> |
| </HTML> |
