You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by bu...@apache.org on 2015/06/27 23:21:05 UTC
svn commit: r956226 [9/34] - in /websites/production/tapestry/content: ./
2010/10/11/ 2010/10/31/ 2010/11/18/ 2010/11/19/ 2010/12/16/ 2010/12/17/
2011/01/10/ 2011/03/29/ 2011/06/13/ 2011/06/24/ 2011/06/29/ 2011/07/29/
2011/08/16/ 2011/08/27/ 2011/10/31...
Modified: websites/production/tapestry/content/component-reference.html
==============================================================================
--- websites/production/tapestry/content/component-reference.html (original)
+++ websites/production/tapestry/content/component-reference.html Sat Jun 27 21:21:02 2015
@@ -27,16 +27,6 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
- <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
- <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
- <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -55,7 +45,7 @@
<input type="submit" value="Search">
</form>
-</div><div class="emblem" style="float:left"><p><a shape="rect" href="index.html"><img class="confluence-embedded-image confluence-external-resource" src="http://tapestry.apache.org/images/tapestry_small.png" data-image-src="http://tapestry.apache.org/images/tapestry_small.png"></a></p></div><div class="title" style="float:left; margin: 0 0 0 3em"><h1 id="SmallBanner-PageTitle">Component Reference</h1></div></div>
+</div><div class="emblem" style="float:left"><p><a shape="rect" href="index.html"><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://tapestry.apache.org/images/tapestry_small.png" data-image-src="http://tapestry.apache.org/images/tapestry_small.png"></span></a></p></div><div class="title" style="float:left; margin: 0 0 0 3em"><h1 id="SmallBanner-PageTitle">Component Reference</h1></div></div>
<div class="clearer"></div>
</div>
@@ -68,46 +58,7 @@
<div id="content">
<div id="ConfluenceContent"><p>Tapestry includes more than 65 built-in components and mixins. In addition, there are hundreds of Tapestry components freely available from others. Of course, Tapestry makes it <a shape="rect" href="component-classes.html">trivially easy</a> to create your own custom components, so if you don't see what you need, just develop them yourself.</p><div class="navmenu" style="float:right; background:#eee; margin:3px; padding:3px">
-<h3>Related Articles</h3>
-<ul class="content-by-label"><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="component-classes.html">Component Classes</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="component-parameters.html">Component Parameters</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="templating-and-markup-faq.html">Templating and Markup FAQ</a>
-
-
- </div>
- </li></ul>
-</div><p><strong>Contents</strong></p><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1428092367336 {padding: 0px;}
-div.rbtoc1428092367336 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1428092367336 li {margin-left: 0px;padding-left: 0px;}
-
-/*]]>*/</style></p><div class="toc-macro rbtoc1428092367336">
-<ul class="toc-indentation"><li>Related Articles</li></ul>
-<ul><li><a shape="rect" href="#ComponentReference-Tapestry-providedComponents">Tapestry-provided Components</a>
-<ul class="toc-indentation"><li><a shape="rect" href="#ComponentReference-AJAX-specificComponents">AJAX-specific Components</a></li><li><a shape="rect" href="#ComponentReference-BeanDisplaying&Editing">Bean Displaying & Editing</a></li><li><a shape="rect" href="#ComponentReference-ConditionalandLoopingComponents">Conditional and Looping Components</a></li><li><a shape="rect" href="#ComponentReference-FormComponents">Form Components</a></li><li><a shape="rect" href="#ComponentReference-Grids,TablesandTrees">Grids, Tables and Trees</a></li><li><a shape="rect" href="#ComponentReference-LinksandButtons">Links and Buttons</a></li><li><a shape="rect" href="#ComponentReference-OutputandMessages">Output and Messages</a></li><li><a shape="rect" href="#ComponentReference-Miscellaneous">Miscellaneous</a></li></ul>
-</li><li><a shape="rect" href="#ComponentReference-TapestryMixins">Tapestry Mixins</a></li><li><a shape="rect" href="#ComponentReference-TapestryPages">Tapestry Pages</a></li><li><a shape="rect" href="#ComponentReference-BaseComponents">Base Components</a></li><li><a shape="rect" href="#ComponentReference-OtherComponentLibraries">Other Component Libraries</a></li></ul>
-</div><h2 id="ComponentReference-Tapestry-providedComponents">Tapestry-provided Components</h2><p>Most Tapestry-provided components are found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/package-summary.html">org.apache.tapestry5.corelib.components</a> package. Other components are included in the separate <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/package-summary.html">org.apache.tapestry5.kaptcha.components</a> and <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/upload/components/package-summary.html">org.apache.tapestry5.upload.components</a> packages.</p><h3 id="ComponentReference-AJAX-specificComponents">AJAX-specific Components</h3><p>Main Article: <a shape="rect" href="ajax-and-zones.html">Ajax and Zones</a></p><div class="table-wrap"><table class
="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/AjaxFormLoop.html">AjaxFormLoop</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A special form of the Loop component that adds Ajax support to handle adding new rows and removing existing rows dynamically.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/AddRowLink.html">AddRowLink</a>, <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RemoveRowLink.html">RemoveRowLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used inside an AjaxFormLoop component to spur the addition or removal of a row.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/ProgressiveDisplay.html">ProgressiveDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to implement the progressive enhancement web design strategy; the component renders itself with a simplified initial content (i.e., "loading ...") and an Ajax request then supplies the component's true body.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Zone.html">Zone</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A region of a page marked for dynamic updating via Ajax or other client-side effects.</p></td></tr></tbody></table></div><h3 id="ComponentReference-BeanDisplaying&Editing">Bean Displaying & Editing</h3><p>Main Article: <a shape=
"rect" href="beaneditform-guide.html">BeanEditForm Guide</a></p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/BeanDisplay.html">BeanDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays the properties of a bean, using an underlying BeanModel, as a dl element with dt/dd pairs.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/BeanEditForm.html">BeanEditForm</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Creates an entire form for editing the properties of a particular bean</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.ap
ache.org/current/apidocs/org/apache/tapestry5/corelib/components/BeanEditor.html">BeanEditor</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The central component of BeanEditForm, this generates a user interface for editing the properties of a bean</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PropertyDisplay.html">PropertyDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Outputs a single property value. Overrides for individual properties come from block parameters whose name matches the property id. This component is used by the BeanDisplay component.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PropertyEditor.html">PropertyEditor</a></p></td><td c
olspan="1" rowspan="1" class="confluenceTd"><p>Used to edit a single property of a bean. This is used primarily by BeanEditForm.</p></td></tr></tbody></table></div><h3 id="ComponentReference-ConditionalandLoopingComponents">Conditional and Looping Components</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/If.html">If</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Conditionally renders its body. May render its tag and any informal parameters</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="switching-cases.html">Case</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Not really a component, but a technique to emulate a "case" statement using a delegate</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"
><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Loop.html">Loop</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Loops over a number of items (provided by its source parameter), rendering its body for each one]</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Unless.html">Unless</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Inverse of the If component, renders its body if the condition is false.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Delegate.html">Delegate</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Does not do any rendering of its own, but will dele
gate to some other object that can do rendering</p></td></tr></tbody></table></div><h3 id="ComponentReference-FormComponents">Form Components</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Checkbox.html">Checkbox</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a standard <input type="checkbox"> element</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Checklist.html">Checklist</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a vertical list of <input type="checkbox"> elements</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" hr
ef="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/DateField.html">DateField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Collect a provided date from the user using a client-side JavaScript calendar</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Form.html">Form</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An HTML form, which will enclose other components to render out the various types of fields.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/FormFragment.html">FormFragment</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A portion of a Form that may be selectively displayed</p></td></tr><tr><td colspa
n="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/FormInjector.html">FormInjector</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Adds new content to an existing Form</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Hidden.html">Hidden</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to record a page property as a value into the form</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Label.html">Label</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a label element for a particular field</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/KaptchaField.html">KaptchaField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of a Captcha based authentication scheme; a KaptchaField is paired with a KaptchaImage to ensure that the user has provided the correct value</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/KaptchaImage.html">KaptchaImage</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of a Captcha based authentication scheme; a KaptchaImage generates a new text image whenever it renders and can provide the previously rendred text subsequently (it is stored persistently in the session)</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" clas
s="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Palette.html">Palette</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A multiple selection component. Generates a UI consisting of two select elements configured for multiple selection; the one on the left is the list of "available" elements, the one on the right is "selected".</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PasswordField.html">PasswordField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A version of TextField, but rendered out as an <input type="password"> element.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Radio.html">Radio</
a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A radio button (i.e., <input type="radio">). Radio buttons must operate within a RadioContainer (normally, the RadioGroup component).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RadioGroup.html">RadioGroup</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Groups together a set of radio components that all affect the same property</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Select.html">Select</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a <select> element for selecting an item from a list of values</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a s
hape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/SubmitNotifier.html">SubmitNotifier</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A non visual component used to provide notifications to its container during a form submission</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextArea.html">TextArea</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a <textarea> element for editing multi-line text</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextField.html">TextField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders an <input type="text"> element t
o edit single-line text</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="uploading-files.html">Upload</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A file upload component (i.e., <input type="file">) based on Apache Commons FileUpload</p></td></tr></tbody></table></div><h3 id="ComponentReference-Grids,TablesandTrees">Grids, Tables and Trees</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Grid.html">Grid</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Presents tabular data in a <table> element by iterating over a List or array</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5
/corelib/components/GridCell.html">GridCell</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of Grid, renders the markup inside a single data cell</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridColumns.html">GridColumns</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of Grid, renders out the column headers for the grid, including links (where appropriate) to control column sorting</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridPager.html">GridPager</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a series of links used to jump to a particular page index within the overall data set</p></td></tr><tr><td colspan="1" rows
pan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridRows.html">GridRows</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders out a series of rows within the table</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Tree.html">Tree</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A component used to render a recursive tree structure, with expandable/collapsable/selectable nodes.</p></td></tr></tbody></table></div><h3 id="ComponentReference-LinksandButtons">Links and Buttons</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/
corelib/components/ActionLink.html">ActionLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Triggers an action on the server with a subsequent full page refresh</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/EventLink.html">EventLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Like ActionLink except that the event that it triggers is explicitly controlled, rather than always "action", and the event is triggered in its container</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/LinkSubmit.html">LinkSubmit</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a client-side hyperlink that submits the enclosing form</p></td></tr><tr><td co
lspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Submit.html">Submit</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Corresponds to <input type="submit"> or <input type="image">, a client-side element that can force the enclosing form to submit</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PageLink.html">PageLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a render request link to some other page in the application</p></td></tr></tbody></table></div><h3 id="ComponentReference-OutputandMessages">Output and Messages</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="
external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Alerts.html">Alerts</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders out an empty <div> element and provides JavaScript initialization to make the element the container for alerts.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Dynamic.html">Dynamic</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Allows a component to render itself differently at different times, by making use of an external template file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Error.html">Error</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Presents va
lidation errors of a single field. Must be enclosed by a Form component</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Errors.html">Errors</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Standard validation error presenter. Must be enclosed by a Form component. If errors are present, renders a div element around a banner message and around an unnumbered list of error messages</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/ExceptionDisplay.html">ExceptionDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Integral part of the default ExceptionReport page used to break apart and display the properties of the exception</p></td></tr><tr><td colspan="1" rowspa
n="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Output.html">Output</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A component for formatting output. If the component is represented in the template using an element, then the element (plus any informal parameters) will be output around the formatted value.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/OutputRaw.html">OutputRaw</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Output raw markup to the client. Unlike an expansion, the output from OutputRaw is unfiltered, with any special characters or entities left exactly as is.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tap
estry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextOutput.html">TextOutput</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Outputs paragraph oriented text, typically collected via a TextArea component. The TextArea is split into lines, and each line it output inside its own p element.</p></td></tr></tbody></table></div><h3 id="ComponentReference-Miscellaneous">Miscellaneous</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Any.html">Any</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders an arbitrary element including informal parameters</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5/corelib/components/Dev
Tool.html">DevTool</a></td><td colspan="1" rowspan="1" class="confluenceTd">Renders a dropdown menu of useful options when developing, such as reloading the current page or invalidating the current HttpSession.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Doctype.html">Doctype</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Overrides the DOCTYPE of the rendered document (via Document.dtd(String, String, String) which can be useful when different component templates that render to the same document disagree about what the correct DOCTYPE is.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RenderObject.html">RenderObject</a></p></td><td colspan="1" rowspan="1" class="confluenceTd
"><p>Renders out an object using the ObjectRenderer service. Used primarily on the ExceptionReport page</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Trigger.html">Trigger</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Triggers an arbitrary event during rendering. This is often useful to add JavaScript to a page or a component (via calls to the JavaScriptSupport environmental).</p></td></tr></tbody></table></div><h2 id="ComponentReference-TapestryMixins">Tapestry Mixins</h2><p>Main Article: <a shape="rect" href="component-mixins.html">Component Mixins</a></p><p>Mixins allow you to add behaviors to existing components. The core mixins are found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/package-summary.html">org.apache.tapestry5.corel
ib.mixins</a> package.</p><p>Tapestry includes the following mixins out-of-the-box.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/Autocomplete.html">Autocomplete</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>modifies a text field to provide for auto-completion of text using values retrieved from the server as the user types. <a shape="rect" href="ajax-and-zones.html#AjaxandZones-autocomplete">See instructions</a>.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5/corelib/mixins/Confirm.html">Confirm</a></td><td colspan="1" rowspan="1" class="confluenceTd">attached to a Form or link component, runs a modal-dialog to force the user to confirm the behavior
.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/DiscardBody.html">DiscardBody</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>discards a component's body. Returns false from the BeforeRenderBody phase, which prevents the rendering of the body.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/FormFieldFocus.html">FormFieldFocus</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>instruments the outer Form on which component the focus should be activated. Replaced by OverrideFieldFocus starting in Tapestry 5.4.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5
/corelib/mixins/FormGroup.html">FormGroup</a></td><td colspan="1" rowspan="1" class="confluenceTd">attached to a field to render an enclosing <div> element and label</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/NotEmpty.html">NotEmpty</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>attaches to any component that renders an element. At the end of the render, if the element is empty, then a non-breaking space (&nbsp;) is injected into the element.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.html">OverrideFieldFocus</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>when attached to a form field, causes that field to gain focus. Starting in Ta
pestry 5.4, this supersedes FormFieldFocus.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderClientId.html">RenderClientId</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>forces a client element to render its client id by ensuring that "getClientId" is called.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderDisabled.html">RenderDisabled</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>renders an "disabled" attribute if the containing component is disabled</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderInformals
.html">RenderInformals</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>renders out all informal parameters, at the end of the BeginRender phase. This mixin can be used with components that render a single tag inside the BeginRender phase.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderNotification.html">RenderNotification</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>triggers event notifications to identify when it enters the BeginRender and AfterRender render phases</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/TriggerFragment.html">TriggerFragment</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>when applied to a Checkbox or Radio component,
links the input field and a FormFragment, making the field control the client-side visibility of the FormFragment</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/ZoneRefresh.html">ZoneRefresh</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>periodically refreshes a Zone by triggering an event on the server using ajax requests.</p></td></tr></tbody></table></div><h2 id="ComponentReference-TapestryPages">Tapestry Pages</h2><p>Tapestry provides several special pages that provide status information. Most of these are found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/package-summary.html">org.apache.tapestry5.corelib.pages</a> package.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenc
eTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/ExceptionReport.html">ExceptionReport</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Responsible for reporting runtime exceptions. This page is quite verbose and is usually overridden in a production application.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PageCatalog.html">PageCatalog</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Lists out the currently loaded pages, with some statistics.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PropertyDisplayBlocks.html">PropertyDisplayBlocks</a></p></td><td colspan="1" rowspan="1" class="conf
luenceTd"><p>Contains blocks for displaying basic property types; the blocks are contributed to the BeanBlockSource service.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PropertyEditBlocks.html">PropertyEditBlocks</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A page that exists to contain blocks used to edit different types of properties. The blocks on this page are contributed into the BeanBlockSource service configuration.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/ServiceStatus.html">ServiceStatus</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A page used to see the status of all services defined by the Registry.</p></td></tr></tbody></table></div><h2 id="C
omponentReference-BaseComponents">Base Components</h2><p>The base components, in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/package-summary.html">org.apache.tapestry5.corelib.base</a> package, are intended to be extended by other components rather than used directly in templates.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractComponentEventLink.html">AbstractComponentEventLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for link-generating components that are based on a component event request. Such events have an event context and may also update a Zone.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http:/
/tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractConditional.html">AbstractConditional</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for If and Unless. Will render its body or the block from its else parameter. If it renders anything and it has an element name, then it renders the element and its informal parameters.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractField.html">AbstractField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Provides initialization of the clientId and elementName properties. In addition, adds the RenderInformals, RenderDisabled and DiscardBody mixins.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/
base/AbstractLink.html">AbstractLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Provides base utilities for classes that generate clickable links.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.html">AbstractPropertyOutput</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for components that output a property value using a PropertyModel</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractTextField.html">AbstractTextField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Abstract class for a variety of components that render some variation of a text field. Most of the hooks for user input validation are in this class</
p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/BaseMessages.html">BaseMessages</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for components that output messages</p></td></tr></tbody></table></div><h2 id="ComponentReference-OtherComponentLibraries">Other Component Libraries</h2><p>See <a shape="rect" href="modules.html">Modules</a></p></div>
+<div class="error"><span class="error">Error formatting macro: contentbylabel: com.atlassian.confluence.api.service.exceptions.BadRequestException: Could not parse cql : null</span> </div></div><p><strong>Contents</strong></p><p></p><div class="toc-macro client-side-toc-macro" data-headerelements="H1,H2,H3,H4,H5,H6,H7"></div><h2 id="ComponentReference-Tapestry-providedComponents">Tapestry-provided Components</h2><p>Most Tapestry-provided components are found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/package-summary.html">org.apache.tapestry5.corelib.components</a> package. Other components are included in the separate <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/package-summary.html">org.apache.tapestry5.kaptcha.components</a> and <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/api
docs/org/apache/tapestry5/upload/components/package-summary.html">org.apache.tapestry5.upload.components</a> packages.</p><h3 id="ComponentReference-AJAX-specificComponents">AJAX-specific Components</h3><p>Main Article: <a shape="rect" href="ajax-and-zones.html">Ajax and Zones</a></p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/AjaxFormLoop.html">AjaxFormLoop</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A special form of the Loop component that adds Ajax support to handle adding new rows and removing existing rows dynamically.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/AddRowLink.html">AddRowLink</a>, <a shape="rect"
class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RemoveRowLink.html">RemoveRowLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used inside an AjaxFormLoop component to spur the addition or removal of a row.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/ProgressiveDisplay.html">ProgressiveDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to implement the progressive enhancement web design strategy; the component renders itself with a simplified initial content (i.e., "loading ...") and an Ajax request then supplies the component's true body.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/compon
ents/Zone.html">Zone</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A region of a page marked for dynamic updating via Ajax or other client-side effects.</p></td></tr></tbody></table></div><h3 id="ComponentReference-BeanDisplaying&Editing">Bean Displaying & Editing</h3><p>Main Article: <a shape="rect" href="beaneditform-guide.html">BeanEditForm Guide</a></p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/BeanDisplay.html">BeanDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Displays the properties of a bean, using an underlying BeanModel, as a dl element with dt/dd pairs.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapest
ry5/corelib/components/BeanEditForm.html">BeanEditForm</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Creates an entire form for editing the properties of a particular bean</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/BeanEditor.html">BeanEditor</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The central component of BeanEditForm, this generates a user interface for editing the properties of a bean</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PropertyDisplay.html">PropertyDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Outputs a single property value. Overrides for individual properties come from block parameters whose name matche
s the property id. This component is used by the BeanDisplay component.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PropertyEditor.html">PropertyEditor</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to edit a single property of a bean. This is used primarily by BeanEditForm.</p></td></tr></tbody></table></div><h3 id="ComponentReference-ConditionalandLoopingComponents">Conditional and Looping Components</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/If.html">If</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Conditionally renders its body. May render its tag and any informal parameters</p></td></tr>
<tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="switching-cases.html">Case</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Not really a component, but a technique to emulate a "case" statement using a delegate</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Loop.html">Loop</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Loops over a number of items (provided by its source parameter), rendering its body for each one]</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Unless.html">Unless</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Inverse of the If component, renders its body if the condition is false.</p></td></tr><
tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Delegate.html">Delegate</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Does not do any rendering of its own, but will delegate to some other object that can do rendering</p></td></tr></tbody></table></div><h3 id="ComponentReference-FormComponents">Form Components</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Checkbox.html">Checkbox</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a standard <input type="checkbox"> element</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/
current/apidocs/org/apache/tapestry5/corelib/components/Checklist.html">Checklist</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a vertical list of <input type="checkbox"> elements</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/DateField.html">DateField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Collect a provided date from the user using a client-side JavaScript calendar</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Form.html">Form</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An HTML form, which will enclose other components to render out the various types of fields.</p></td></tr><tr><td colspan="1" rowspan="1" class="
confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/FormFragment.html">FormFragment</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A portion of a Form that may be selectively displayed</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/FormInjector.html">FormInjector</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Adds new content to an existing Form</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Hidden.html">Hidden</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Used to record a page property as a value into the form</p></td></tr><tr><td colspan="1" rowsp
an="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Label.html">Label</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a label element for a particular field</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/KaptchaField.html">KaptchaField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of a Captcha based authentication scheme; a KaptchaField is paired with a KaptchaImage to ensure that the user has provided the correct value</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/kaptcha/components/KaptchaImage.html">KaptchaImage</a></p></td><td colspan="1" rowspan="1" c
lass="confluenceTd"><p>Part of a Captcha based authentication scheme; a KaptchaImage generates a new text image whenever it renders and can provide the previously rendred text subsequently (it is stored persistently in the session)</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Palette.html">Palette</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A multiple selection component. Generates a UI consisting of two select elements configured for multiple selection; the one on the left is the list of "available" elements, the one on the right is "selected".</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PasswordField.html">PasswordField</a></p></td><td colspan="1" rowspan="1" clas
s="confluenceTd"><p>A version of TextField, but rendered out as an <input type="password"> element.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Radio.html">Radio</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A radio button (i.e., <input type="radio">). Radio buttons must operate within a RadioContainer (normally, the RadioGroup component).</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RadioGroup.html">RadioGroup</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Groups together a set of radio components that all affect the same property</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" hr
ef="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Select.html">Select</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a <select> element for selecting an item from a list of values</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/SubmitNotifier.html">SubmitNotifier</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A non visual component used to provide notifications to its container during a form submission</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextArea.html">TextArea</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders a <textarea> element for editing multi-line text</p></td></t
r><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextField.html">TextField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders an <input type="text"> element to edit single-line text</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="uploading-files.html">Upload</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A file upload component (i.e., <input type="file">) based on Apache Commons FileUpload</p></td></tr></tbody></table></div><h3 id="ComponentReference-Grids,TablesandTrees">Grids, Tables and Trees</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Grid.html">Grid</a
></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Presents tabular data in a <table> element by iterating over a List or array</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridCell.html">GridCell</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of Grid, renders the markup inside a single data cell</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridColumns.html">GridColumns</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Part of Grid, renders out the column headers for the grid, including links (where appropriate) to control column sorting</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="extern
al-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridPager.html">GridPager</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a series of links used to jump to a particular page index within the overall data set</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/GridRows.html">GridRows</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders out a series of rows within the table</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Tree.html">Tree</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A component used to render a recursive tree structure, with expandable/collapsable/selectable nodes.</p></t
d></tr></tbody></table></div><h3 id="ComponentReference-LinksandButtons">Links and Buttons</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/ActionLink.html">ActionLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Triggers an action on the server with a subsequent full page refresh</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/EventLink.html">EventLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Like ActionLink except that the event that it triggers is explicitly controlled, rather than always "action", and the event is triggered in its container</p></td></tr><tr><td colspan="1" rowspan="1" class="conf
luenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/LinkSubmit.html">LinkSubmit</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Generates a client-side hyperlink that submits the enclosing form</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Submit.html">Submit</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Corresponds to <input type="submit"> or <input type="image">, a client-side element that can force the enclosing form to submit</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/PageLink.html">PageLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd
"><p>Generates a render request link to some other page in the application</p></td></tr></tbody></table></div><h3 id="ComponentReference-OutputandMessages">Output and Messages</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Alerts.html">Alerts</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders out an empty <div> element and provides JavaScript initialization to make the element the container for alerts.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Dynamic.html">Dynamic</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Allows a component to render itself differently at different times, by making us
e of an external template file.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Error.html">Error</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Presents validation errors of a single field. Must be enclosed by a Form component</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Errors.html">Errors</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Standard validation error presenter. Must be enclosed by a Form component. If errors are present, renders a div element around a banner message and around an unnumbered list of error messages</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apa
che.org/current/apidocs/org/apache/tapestry5/corelib/components/ExceptionDisplay.html">ExceptionDisplay</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Integral part of the default ExceptionReport page used to break apart and display the properties of the exception</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Output.html">Output</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A component for formatting output. If the component is represented in the template using an element, then the element (plus any informal parameters) will be output around the formatted value.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/OutputRaw.html">OutputRaw</a></p></td><td colsp
an="1" rowspan="1" class="confluenceTd"><p>Output raw markup to the client. Unlike an expansion, the output from OutputRaw is unfiltered, with any special characters or entities left exactly as is.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/TextOutput.html">TextOutput</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Outputs paragraph oriented text, typically collected via a TextArea component. The TextArea is split into lines, and each line it output inside its own p element.</p></td></tr></tbody></table></div><h3 id="ComponentReference-Miscellaneous">Miscellaneous</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Any.html
">Any</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders an arbitrary element including informal parameters</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5/corelib/components/DevTool.html">DevTool</a></td><td colspan="1" rowspan="1" class="confluenceTd">Renders a dropdown menu of useful options when developing, such as reloading the current page or invalidating the current HttpSession.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Doctype.html">Doctype</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Overrides the DOCTYPE of the rendered document (via Document.dtd(String, String, String) which can be useful when different component templates that render to the same document disagree a
bout what the correct DOCTYPE is.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/RenderObject.html">RenderObject</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Renders out an object using the ObjectRenderer service. Used primarily on the ExceptionReport page</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Trigger.html">Trigger</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Triggers an arbitrary event during rendering. This is often useful to add JavaScript to a page or a component (via calls to the JavaScriptSupport environmental).</p></td></tr></tbody></table></div><h2 id="ComponentReference-TapestryMixins">Tapestry Mixins</h2><p>Main Article: <a shape="rec
t" href="component-mixins.html">Component Mixins</a></p><p>Mixins allow you to add behaviors to existing components. The core mixins are found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/package-summary.html">org.apache.tapestry5.corelib.mixins</a> package.</p><p>Tapestry includes the following mixins out-of-the-box.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/Autocomplete.html">Autocomplete</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>modifies a text field to provide for auto-completion of text using values retrieved from the server as the user types. <a shape="rect" href="ajax-and-zones.html#AjaxandZones-autocomplete">See instructions</a>.</p></td></tr><tr><td colspan="1" rowspan="
1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5/corelib/mixins/Confirm.html">Confirm</a></td><td colspan="1" rowspan="1" class="confluenceTd">attached to a Form or link component, runs a modal-dialog to force the user to confirm the behavior.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/DiscardBody.html">DiscardBody</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>discards a component's body. Returns false from the BeforeRenderBody phase, which prevents the rendering of the body.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/FormFieldFocus.html">FormFieldFocus</a></p></td><td colspan="1" rowspan="1" class=
"confluenceTd"><p>instruments the outer Form on which component the focus should be activated. Replaced by OverrideFieldFocus starting in Tapestry 5.4.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><a shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/apidocs/org/apache/tapestry5/corelib/mixins/FormGroup.html">FormGroup</a></td><td colspan="1" rowspan="1" class="confluenceTd">attached to a field to render an enclosing <div> element and label</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/NotEmpty.html">NotEmpty</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>attaches to any component that renders an element. At the end of the render, if the element is empty, then a non-breaking space (&nbsp;) is injected into the element.</p></td></tr><tr><td colspan="1" rowspan="1" class="confl
uenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.html">OverrideFieldFocus</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>when attached to a form field, causes that field to gain focus. Starting in Tapestry 5.4, this supersedes FormFieldFocus.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderClientId.html">RenderClientId</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>forces a client element to render its client id by ensuring that "getClientId" is called.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderDisabled.html">RenderDisabled</a></p></td><td colspa
n="1" rowspan="1" class="confluenceTd"><p>renders an "disabled" attribute if the containing component is disabled</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderInformals.html">RenderInformals</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>renders out all informal parameters, at the end of the BeginRender phase. This mixin can be used with components that render a single tag inside the BeginRender phase.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/RenderNotification.html">RenderNotification</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>triggers event notifications to identify when it enters the BeginRender and AfterRender render phases</p></td></tr><tr><t
d colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/TriggerFragment.html">TriggerFragment</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>when applied to a Checkbox or Radio component, links the input field and a FormFragment, making the field control the client-side visibility of the FormFragment</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/mixins/ZoneRefresh.html">ZoneRefresh</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>periodically refreshes a Zone by triggering an event on the server using ajax requests.</p></td></tr></tbody></table></div><h2 id="ComponentReference-TapestryPages">Tapestry Pages</h2><p>Tapestry provides several special pages that provide status information. Most of these a
re found in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/package-summary.html">org.apache.tapestry5.corelib.pages</a> package.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/ExceptionReport.html">ExceptionReport</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Responsible for reporting runtime exceptions. This page is quite verbose and is usually overridden in a production application.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PageCatalog.html">PageCatalog</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Lists out the currently loaded
pages, with some statistics.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PropertyDisplayBlocks.html">PropertyDisplayBlocks</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Contains blocks for displaying basic property types; the blocks are contributed to the BeanBlockSource service.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/PropertyEditBlocks.html">PropertyEditBlocks</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A page that exists to contain blocks used to edit different types of properties. The blocks on this page are contributed into the BeanBlockSource service configuration.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect
" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/pages/ServiceStatus.html">ServiceStatus</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A page used to see the status of all services defined by the Registry.</p></td></tr></tbody></table></div><h2 id="ComponentReference-BaseComponents">Base Components</h2><p>The base components, in the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/package-summary.html">org.apache.tapestry5.corelib.base</a> package, are intended to be extended by other components rather than used directly in templates.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractComponentEventLink.html">AbstractComponentEventLink</a></p></td
><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for link-generating components that are based on a component event request. Such events have an event context and may also update a Zone.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractConditional.html">AbstractConditional</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for If and Unless. Will render its body or the block from its else parameter. If it renders anything and it has an element name, then it renders the element and its informal parameters.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractField.html">AbstractField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Provides i
nitialization of the clientId and elementName properties. In addition, adds the RenderInformals, RenderDisabled and DiscardBody mixins.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractLink.html">AbstractLink</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Provides base utilities for classes that generate clickable links.</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.html">AbstractPropertyOutput</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for components that output a property value using a PropertyModel</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapes
try.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/AbstractTextField.html">AbstractTextField</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Abstract class for a variety of components that render some variation of a text field. Most of the hooks for user input validation are in this class</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/base/BaseMessages.html">BaseMessages</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Base class for components that output messages</p></td></tr></tbody></table></div><h2 id="ComponentReference-OtherComponentLibraries">Other Component Libraries</h2><p>See <a shape="rect" href="modules.html">Modules</a></p></div>
</div>
<div class="clearer"></div>
Modified: websites/production/tapestry/content/component-rendering.html
==============================================================================
--- websites/production/tapestry/content/component-rendering.html (original)
+++ websites/production/tapestry/content/component-rendering.html Sat Jun 27 21:21:02 2015
@@ -27,16 +27,6 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
- <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
- <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
- <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
- <script src='/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -55,7 +45,7 @@
<input type="submit" value="Search">
</form>
-</div><div class="emblem" style="float:left"><p><a shape="rect" href="index.html"><img class="confluence-embedded-image confluence-external-resource" src="http://tapestry.apache.org/images/tapestry_small.png" data-image-src="http://tapestry.apache.org/images/tapestry_small.png"></a></p></div><div class="title" style="float:left; margin: 0 0 0 3em"><h1 id="SmallBanner-PageTitle">Component Rendering</h1></div></div>
+</div><div class="emblem" style="float:left"><p><a shape="rect" href="index.html"><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://tapestry.apache.org/images/tapestry_small.png" data-image-src="http://tapestry.apache.org/images/tapestry_small.png"></span></a></p></div><div class="title" style="float:left; margin: 0 0 0 3em"><h1 id="SmallBanner-PageTitle">Component Rendering</h1></div></div>
<div class="clearer"></div>
</div>
@@ -70,72 +60,7 @@
<div id="ConfluenceContent"><h1 id="ComponentRendering-ComponentRendering">Component Rendering</h1>
<div class="navmenu" style="float:right; background:#eee; margin:3px; padding:3px">
-<h3>Related Articles</h3>
-<ul class="content-by-label"><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="content-type-and-markup.html">Content Type and Markup</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="component-events-faq.html">Component Events FAQ</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="request-processing.html">Request Processing</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="page-life-cycle.html">Page Life Cycle</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="component-rendering.html">Component Rendering</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="page-navigation.html">Page Navigation</a>
-
-
- </div>
- </li><li>
- <div>
- <span class="icon icon-page" title="Page">Page:</span> </div>
-
- <div class="details">
- <a shape="rect" href="component-events.html">Component Events</a>
-
-
- </div>
- </li></ul>
-</div>
+<div class="error"><span class="error">Error formatting macro: contentbylabel: com.atlassian.confluence.api.service.exceptions.BadRequestException: Could not parse cql : null</span> </div></div>
<p>Rendering of components in Tapestry 5 is based on a <em>state machine</em> and a <em>queue</em> (instead of the tail recursion used in Tapestry 4). This breaks the rendering process up into tiny pieces that can easily be implemented or overridden. Don't worry, in practice, writing components requires a breathtakingly small amount of code.</p>
@@ -144,7 +69,7 @@
<p>The rendering of each component is divided into a number of phases, illustrated below.</p>
-<p><img class="confluence-embedded-image" src="component-rendering.data/tapestry_render_phases.png" data-image-src="/confluence/download/attachments/21792222/tapestry_render_phases.png?version=3&modificationDate=1381833043000&api=v2" title="Component Render Phases"><br clear="none">
+<p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="component-rendering.data/tapestry_render_phases.png" data-image-src="/confluence/download/attachments/21792222/tapestry_render_phases.png?version=3&modificationDate=1381833043000&api=v2" data-unresolved-comment-count="0" data-linked-resource-id="35192977" data-linked-resource-version="3" data-linked-resource-type="attachment" data-linked-resource-default-alias="tapestry_render_phases.png" data-base-url="https://cwiki.apache.org/confluence" data-linked-resource-content-type="image/png" data-linked-resource-container-id="21792222" data-linked-resource-container-version="27" title="Component Render Phases"></span><br clear="none">
Each of the orange phases (SetupRender, BeginRender, BeforeRenderBody, etc.) corresponds to an annotation you may place on one or more methods of your class. The annotation directs Tapestry to invoke your method as part of that phase.</p>
<p>Methods marked with these annotations are called <strong>render phase methods</strong>.</p>
@@ -167,7 +92,7 @@ Each of the orange phases (SetupRender,
<p>Here's the source for a looping component that counts up or down between two values, renders its body a number of times, and stores the current index value in a parameter:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
package org.example.app.components;
import org.apache.tapestry5.annotations.Parameter;
@@ -235,14 +160,8 @@ public class Count
<div class="navmenu" style="float:right; width:50%; background:#eee; margin:3px; padding:3px">
- <div class="aui-message warning shadowed information-macro">
- <span class="aui-icon icon-warning">Icon</span>
- <div class="message-content">
-
-<p>The SetupRender phase, like all render phases, occurs once for each rendering of the component. If the component is inside a looping component (<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Loop.html">Loop</a>, <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Grid.html">Grid</a>, etc.), then the SetupRender method will be called once for <em>each</em> iteration of the loop.</p>
- </div>
- </div>
-</div>
+<div class="confluence-information-macro confluence-information-macro-note"><span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span><div class="confluence-information-macro-body">
+<p>The SetupRender phase, like all render phases, occurs once for each rendering of the component. If the component is inside a looping component (<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Loop.html">Loop</a>, <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Grid.html">Grid</a>, etc.), then the SetupRender method will be called once for <em>each</em> iteration of the loop.</p></div></div></div>
<h3 id="ComponentRendering-SetupRender">SetupRender</h3>
@@ -291,7 +210,7 @@ public class Count
<p>Using this mechanism, the earlier example can be rewritten as:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
package org.example.app.components;
import org.apache.tapestry5.annotations.Parameter;
@@ -370,7 +289,7 @@ public class Count
<p>The following component returns a Renderable in the BeginRender phase and skips the BeforeRenderTemplate phase:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
public class OutputValueComponent
{
@Parameter
@@ -438,7 +357,7 @@ public class OutputValueComponent
<p>To turn on rendering comments only for a particular request, add the query parameter <code>t:component-trace=true</code> to the URL:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
http://www.example.com/myapp/mypage?t:component-trace=true
]]></script>
</div></div></div>