dgraham 2002/12/22 15:10:29 Modified: doc/userGuide building_view.xml Log: Added text for section 3.4.3 Tiles. Revision Changes Path 1.21 +55 -2 jakarta-struts/doc/userGuide/building_view.xml Index: building_view.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_view.xml,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- building_view.xml 22 Dec 2002 19:41:19 -0000 1.20 +++ building_view.xml 22 Dec 2002 23:10:28 -0000 1.21 @@ -685,10 +685,63 @@ </section> <section name="3.4.3 Page Composition With Tiles" href="Tiles"> - <p> - [:TODO:] + Tiles is a powerful templating library that allows you to construct views by combining + various "tiles". Here's a quick setup guide: </p> + <ol> + <li>Create a /layout/layout.jsp file that contains your app's common look and feel: + <pre> + <html> + <body> + <tiles:insert attribute="body"/> + </body> + </html> + </pre> + </li> + <li> + Create your /index.jsp homepage file: + <pre> + <h1>This is my homepage!</h1> + </pre> + </li> + <li>Create a /WEB-INF/tiles-defs.xml file that looks like this:<br/> + <pre> + <tiles-definitions> + <definition name="layout" path="/layout/layout.jsp"> + <put name="body" value=""/> + </definition> + <definition name="homepage" extends="layout"> + <put name="body" value="/index.jsp"/> + </definition> + <tiles-definitions> + </pre> + </li> + <li> + Setup the TilesPlugin in the struts-config.xml file: + <pre> + <plug-in className="org.apache.struts.tiles.TilesPlugin"> + <set-property property="definitions-config" value="/WEB-INF/tiles-defs.xml"/> + </plug-in> + </pre> + </li> + <li> + Setup an action mapping in struts-config.xml to point to your homepage tile: + <pre> + <action + path="/index" + type="org.apache.struts.actions.ForwardAction" + parameter="homepage"/> + </pre> + </li> + </ol> + <p> + The TilesPlugin configures a special RequestProcessor that determines if the requested view is a + tile and processes it accordingly. Note that we made the homepage tile extend our root layout + tile and changed the body attribute. Tiles inserts the file named in the body attribute into the main + layout. + </p> + <p>See the the tiles-documentation webapp for in-depth examples.</p> </section> <section name="3.4.4 Image Rendering Components" href="image_rendering">
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>