husted 2002/06/27 07:23:05 Added: doc/userGuide dev_tiles.xml Log: Initial draft of home page for Tiles Developer Guide. Work in progress. Revision Changes Path 1.1 jakarta-struts/doc/userGuide/dev_tiles.xml Index: dev_tiles.xml =================================================================== <?xml version="1.0" encoding="ISO-8859-1"?> <document url="./resources.xml"> <properties> <author>Ted Husted</author> <author>Cedric Dumoulin</author> <title>The Struts User's Guide - Validating user input</title> </properties> <body> <chapter name="Tiles Developer Guide"> <section href="tiles" name="The Tiles Document Assembly Framework"> <p>Tiles builds on the "include" feature provided by the JavaServer Page specification to provided a full-featured, robost framework for assembling presentation pages from component parts. Each part, or tile, can be reused as often as needed throughout your application. This reduces the amount of markup that needs to be maintained and makes it easier to change the look and feel of a website. </p> </section> <section href="features" name="Overview of Tiles Features"> <ul> <li> Screen definitions <ul> <li> Create a screen by assembling <strong><em>Tiles</em></strong> : header, footer, menu, body </li> <li> Definitions can take place : <ul> <li> in a centralized xml file </li> <li> directly in jsp page </li> <li> in struts action </li> </ul> </li> <li> Definitions provide an inheritance mechanism : a definition can extends another one, and override parameters. </li> </ul> </li> <li> Templating <ul> <li> <strong><em>Tiles</em></strong> framework is entirely compatible with <em>Templates</em> defined by David Geary and implemented in Struts </li> <li> You can replace <em>Templates</em> library by <strong><em>Tiles</em></strong> one </li> </ul> </li> <li> Layouts <ul> <li> Define common page layouts and reuse them across your web site </li> <li> Define menu layouts, and use them by passing lists of items and links </li> <li> Define portal layout, use it by passing list of <strong><em>Tiles</em></strong> (pages) to show </li> <li> Reuse existing layouts, or define your owns </li> </ul> </li> <li> Dynamic page building <ul> <li> Tiles are gather dynamically during page reload. It is possible to change any attributes : layout, list of Tiles in portal, list of menu items, ... </li> </ul> </li> <li> Reuse of <strong><em>Tiles</em></strong> / Components <ul> <li> If well defined, a <strong><em>Tile</em></strong> can be reused in different location </li> <li> Dynamic attributes are used to parameterized <em><strong>Tiles</strong></em> </li> <li> It is possible to define library of reusable <em><strong>Tiles</strong></em>. </li> <li> Build a page by assembling predefined components, give them appropriate parameters </li> </ul> </li> <li> Internationalization (i18n) </li> <ul> <li> It is possible to load different tiles according to Locale </li> <li> A mechanism similar to Java properties files is used for definitions files : you can have one definition file per Locale. The appropriate definition is loaded according to current Locale </li> </ul> <li> Multi-channels </li> <ul> <li> It is possible to load different Tiles according to a key stored in jsp session, or anywhere. </li> <li> For example, key could be user provilege, browser type, ... </li> <li> A mechanism similar to Java properties files is used for definitions files : you can have one definition file per key. The appropriate definition is loaded according to the key. </li> </ul></ul> </section> <section href="setup" name="Enabling your application for Tiles"> <p>The Tiles framework is bundled with Struts. It is not enabled by default. To enable Tiles you need to: </p> <ul> <li>Setup the struts-tiles taglib in your web.xml</li> <li>Add the Tiles Request controller to your struts-config.xml</li> </ul> <p>[:TODO: additional detail.]</p> </section> <section href="tiles" name="Tiles API Guide"> <p> A concise <a href="http://jakarta.apache.org/struts/api/org/apache/struts/taglib/template/package-summary.html#package_description">Tiles API Guide</a> is available to help you get started with the Tiles framework. [:TODO: Change link to Tiles API Guide when available.] </p> </section> <section href="resources" name="Tiles Resources"> <p><a href="http://www-106.ibm.com/developerworks/java/library/j-strutstiles.html?loc=j">Struts and Tiles aid component-based development</a> by Wellie Chao.</p> <p><a href="http://www.javaworld.com/javaworld/jw-01-2002/jw-0104-tilestrut.html"><b>UI design with Tiles and Struts</b></a> by Prakash Malani.</p> <p><u>Developing applications with Tiles</u> by Cedric Dumoulin and Ted Husted. Sample chapter from <u>Java Web Development with Struts</u>; available as a <u>free download</u> (PDF). </p> </section> </chapter></body></document>
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>