Modified: websites/production/tapestry/content/support.html ============================================================================== --- websites/production/tapestry/content/support.html (original) +++ websites/production/tapestry/content/support.html Sat Feb 3 18:21:36 2018 @@ -36,13 +36,26 @@ <div class="wrapper bs"> - <div id="navigation"><div class="nav"><ul class="alternate"><li><a href="index.html">Home</a></li><li><a href="getting-started.html">Getting Started</a></li><li><a href="documentation.html">Documentation</a></li><li><a href="download.html">Download</a></li><li><a href="about.html">About</a></li><li><a class="external-link" href="http://www.apache.org/licenses/LICENSE-2.0";>License</a></li><li><a href="community.html">Community</a></li><li><a class="external-link" href="http://www.apache.org/security/";>Security</a></li><li><a class="external-link" href="http://www.apache.org/";>Apache</a></li><li><a class="external-link" href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a class="external-link" href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></div></div> + <div id="navigation"><div class="nav"><ul class="alternate"><li><a href="index.html">Home</a></li><li><a href="getting-started.html">Getting Started</a></li><li><a href="documentation.html">Documentation</a></li><li><a href="download.html">Download</a></li><li><a href="about.html">About</a></li><li><a class="external-link" href="http://www.apache.org/licenses/LICENSE-2.0";>License</a></li><li><a href="community.html">Community</a></li><li><a class="external-link" href="http://www.apache.org/security/";>Security</a></li><li><a class="external-link" href="http://www.apache.org/";>Apache</a></li><li><a class="external-link" href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a class="external-link" href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></div> + +</div> <div id="top"> - <div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span><form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html";> - <input type="text" name="q"> - <input type="submit" value="Search"> -</form></div><div class="emblem" style="float:left"><p><a 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">Support</h1></div></div> + <div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span> +<form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html";> + <input type="text" name="q"> + <input type="submit" value="Search"> +</form> + +</div> + + +<div class="emblem" style="float:left"><p><a 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">Support</h1></div> + +</div> <div class="clearer"></div> </div> @@ -54,7 +67,7 @@ </div> <div id="content"> - <div id="ConfluenceContent"><p>Apache Tapestry is an open source project and as such, supported by the community. Even if you are looking for commercial support, your best bet for support is to first subscribe to Apache Tapestry user mailing list and ask there. Read more about how to <a href="community.html">get involved</a>.</p><h3 id="Support-CommercialTrainingandSupport">Commercial Training and Support</h3><p>Training on Tapestry and Support is available directly from the source: the Tapestry project committers:</p><ul><li><a class="external-link" href="http://www.arsmachina.com.br/services"; rel="nofollow">Thiago H. de Paula Figueriredo</a>: Provides training and support on Tapestry and related technologies including Spring and Hibernate</li></ul><h3 id="Support-CommunitySupport">Community Support</h3><p>Like all Apache projects, Tapestry uses mailing lists for most communication. You can subscribe by sending e-mail to the addresses below. For each list, there a re subscribe, unsubscribe, and archive links. All Tapestry users are welcome to subscribe to any of these lists, however questions on how to <em>use</em> Tapestry in your application are best sent to the <em>user</em> mailing list.</p><p>Please note that the Nabble archives are set to read-only and don't allow for posting or answering using Nabble's web interface. You have to subscribe to the mailing list in order to post.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><th colspan="1" rowspan="1" class="confluenceTh"><p>Subscribe</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Unsubscribe</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Apache Archive</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Nabble Archive</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>MarkMail Archive</p></th></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tape stry User List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-users/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/Tapestry-User-f2375125.html"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.users"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>T apestry Developer List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-dev/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/Tapestry-Dev-f2438278.html"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.dev"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Ta pestry Commits List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-commits/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.commits"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Search Multiple Lists</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=#query:+page:1+state:facets"; rel="nofollow">tapestry.markmail.org</a></p></td></tr></tbody></table></div></div> + <div id="ConfluenceContent"><p>Apache Tapestry is an open source project and as such, supported by the community. Even if you are looking for commercial support, your best bet for support is to first subscribe to Apache Tapestry user mailing list and ask there. Read more about how to <a href="support.html">get involved</a>.</p><h3 id="Support-CommercialTrainingandSupport">Commercial Training and Support</h3><p>Training on Tapestry and Support is available directly from the source: the Tapestry project committers:</p><ul><li><a class="external-link" href="http://www.arsmachina.com.br/services"; rel="nofollow">Thiago H. de Paula Figueriredo</a>: Provides training and support on Tapestry and related technologies including Spring and Hibernate</li></ul><h3 id="Support-CommunitySupport">Community Support</h3><p>Like all Apache projects, Tapestry uses mailing lists for most communication. You can subscribe by sending e-mail to the addresses below. For each list, there are subscribe, unsubscribe, and archive links. All Tapestry users are welcome to subscribe to any of these lists, however questions on how to <em>use</em> Tapestry in your application are best sent to the <em>user</em> mailing list.</p><p>Please note that the Nabble archives are set to read-only and don't allow for posting or answering using Nabble's web interface. You have to subscribe to the mailing list in order to post.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><th colspan="1" rowspan="1" class="confluenceTh"><p>Subscribe</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Unsubscribe</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Apache Archive</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Nabble Archive</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>MarkMail Archive</p></th></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tapest ry User List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-users/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/Tapestry-User-f2375125.html"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.users"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tap estry Developer List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-dev/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/Tapestry-Dev-f2438278.html"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.dev"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tape stry Commits List</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Subscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="mailto:[email protected]"; rel="nofollow">Unsubscribe</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://mail-archives.apache.org/mod_mbox/tapestry-commits/";>mail-archives.apache.org</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=list%3Aorg.apache.tapestry.commits"; rel="nofollow">tapestry.markmail.org</a></p></td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Search Multiple Lists</p></th><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" c lass="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>-</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.1045711.n5.nabble.com/"; rel="nofollow">www.nabble.com</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a class="external-link" href="http://tapestry.markmail.org/search/?q=#query:+page:1+state:facets"; rel="nofollow">tapestry.markmail.org</a></p></td></tr></tbody></table></div></div> </div> <div class="clearer"></div>
Modified: websites/production/tapestry/content/supporting-informal-parameters.html ============================================================================== --- websites/production/tapestry/content/supporting-informal-parameters.html (original) +++ websites/production/tapestry/content/supporting-informal-parameters.html Sat Feb 3 18:21:36 2018 @@ -44,13 +44,26 @@ <div class="wrapper bs"> - <div id="navigation"><div class="nav"><ul class="alternate"><li><a href="index.html">Home</a></li><li><a href="getting-started.html">Getting Started</a></li><li><a href="documentation.html">Documentation</a></li><li><a href="download.html">Download</a></li><li><a href="about.html">About</a></li><li><a class="external-link" href="http://www.apache.org/licenses/LICENSE-2.0";>License</a></li><li><a href="community.html">Community</a></li><li><a class="external-link" href="http://www.apache.org/security/";>Security</a></li><li><a class="external-link" href="http://www.apache.org/";>Apache</a></li><li><a class="external-link" href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a class="external-link" href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></div></div> + <div id="navigation"><div class="nav"><ul class="alternate"><li><a href="index.html">Home</a></li><li><a href="getting-started.html">Getting Started</a></li><li><a href="documentation.html">Documentation</a></li><li><a href="download.html">Download</a></li><li><a href="about.html">About</a></li><li><a class="external-link" href="http://www.apache.org/licenses/LICENSE-2.0";>License</a></li><li><a href="community.html">Community</a></li><li><a class="external-link" href="http://www.apache.org/security/";>Security</a></li><li><a class="external-link" href="http://www.apache.org/";>Apache</a></li><li><a class="external-link" href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a class="external-link" href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></div> + +</div> <div id="top"> - <div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span><form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html";> - <input type="text" name="q"> - <input type="submit" value="Search"> -</form></div><div class="emblem" style="float:left"><p><a 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">Supporting Informal Parameters</h1></div></div> + <div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span> +<form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html";> + <input type="text" name="q"> + <input type="submit" value="Search"> +</form> + +</div> + + +<div class="emblem" style="float:left"><p><a 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">Supporting Informal Parameters</h1></div> + +</div> <div class="clearer"></div> </div> @@ -62,31 +75,58 @@ </div> <div id="content"> - <div id="ConfluenceContent"><p> <strong>Informal parameters</strong> are any additional parameters beyond the parameters explicitly defined for a component using the <a class="external-link" href="http://tapestry.apache.org/tapestry5/apidocs/org/apache/tapestry5/annotations/Parameter.html";>Parameter</a> annotation.</p><div class="aui-label" style="float:right" title="Related Articles"><h3>Related Articles</h3><ul class="content-by-label"><li> - <div> - <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> - </div> - <div class="details"> - <a href="enum-parameter-recipe.html">Enum Parameter Recipe</a> - </div> </li><li> - <div> - <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> - </div> - <div class="details"> - <a href="supporting-informal-parameters.html">Supporting Informal Parameters</a> - </div> </li><li> - <div> - <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> - </div> - <div class="details"> - <a href="default-parameter.html">Default Parameter</a> - </div> </li><li> - <div> - <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> - </div> - <div class="details"> - <a href="component-parameters.html">Component Parameters</a> - </div> </li></ul></div><p>Any component that closely emulates a particular HTML element <em>should</em> support informal parameters. You'll find that many of the built-in Tapestry components, such as Form, Label and TextField, do exactly that.</p><p>To support informal parameters, a component class should use either the @<a class="external-link" href="http://tapestry.apache.org/tapestry5/apidocs/org/apache/tapestry5/annotations/SupportsInformalParameters.html";>SupportsInformalParameters</a> annotation or the RenderInformals mixin. Otherwise, providing informal parameters to a component will do nothing: any additional parameters will be ignored.</p><h3 id="SupportingInformalParameters-Approach1:@SupportsInformalParameters">Approach 1: @SupportsInformalParameters</h3><p>In the example below we create an Img component, a custom replacement for the <img> tag. Its src parameter will be an asset. We'll use the @SupportsInformalParameters annotation to tell Tapestry that the compo nent should support informal parameters.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> + <div id="ConfluenceContent"><p> <strong>Informal parameters</strong> are any additional parameters (aka HTML attributes) beyond the those explicitly defined for a component using the <a class="external-link" href="http://tapestry.apache.org/tapestry5/apidocs/org/apache/tapestry5/annotations/Parameter.html";>Parameter</a> annotation.</p><div class="aui-label" style="float:right" title="Related Articles"> + + + + + + + + +<h3>Related Articles</h3> + +<ul class="content-by-label"><li> + <div> + <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> </div> + + <div class="details"> + <a href="enum-parameter-recipe.html">Enum Parameter Recipe</a> + + + </div> + </li><li> + <div> + <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> </div> + + <div class="details"> + <a href="supporting-informal-parameters.html">Supporting Informal Parameters</a> + + + </div> + </li><li> + <div> + <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> </div> + + <div class="details"> + <a href="default-parameter.html">Default Parameter</a> + + + </div> + </li><li> + <div> + <span class="icon aui-icon aui-icon-small aui-iconfont-page-default" title="Page">Page:</span> </div> + + <div class="details"> + <a href="component-parameters.html">Component Parameters</a> + + + </div> + </li></ul> +</div> + + +<p>Any component that closely emulates a particular HTML element <strong><em>should</em></strong> support informal parameters, because it gives users of your component the ability to easily add HTML attributes to the HTML that your component emits. You'll find that most of the built-in Tapestry components, such as Form, Label and TextField, do exactly that.</p><p>To support informal parameters, a component class should use either the @<a class="external-link" href="http://tapestry.apache.org/tapestry5/apidocs/org/apache/tapestry5/annotations/SupportsInformalParameters.html";>SupportsInformalParameters</a> annotation or the RenderInformals mixin. Otherwise, providing informal parameters to a component will do nothing: any additional parameters will be ignored.</p><h3 id="SupportingInformalParameters-Approach1:@SupportsInformalParameters">Approach 1: @SupportsInformalParameters</h3><p>In the example below we create an Img component, a custom replacement for the <img> tag. Its sr c parameter will be an asset. We'll use the @SupportsInformalParameters annotation to tell Tapestry that the component should support informal parameters.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">@SupportsInformalParameters public class Img { Modified: websites/production/tapestry/content/switching-cases.html ============================================================================== --- websites/production/tapestry/content/switching-cases.html (original) +++ websites/production/tapestry/content/switching-cases.html Sat Feb 3 18:21:36 2018 @@ -27,6 +27,16 @@ </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> + SyntaxHighlighter.defaults['toolbar'] = false; + SyntaxHighlighter.all(); + </script> <link href="/styles/style.css" rel="stylesheet" type="text/css"/> @@ -67,10 +77,10 @@ </div> <div id="content"> - <div id="ConfluenceContent"><p> </p><parameter ac:name="hidden">true</parameter><parameter ac:name="atlassian-macro-output-type">BLOCK</parameter><rich-text-body><p>Performing the equivalent of a "switch" statement in your component template using blocks and a delegate</p></rich-text-body><h1 id="SwitchingCases-SwitchingCases">Switching Cases</h1><p>With Tapestry's <code>If</code> component you can only test one condition at a time. In order to distinguish multiple cases, you'd have to write complex nested if/else constructs in your page template and have a checker method for each test inside your page class.<plain-text-body>{float:right|background=#eee|padding=0 1em} - *JumpStart Demo:* - [If, Not, Negate, Switch, Else, Unless|http://jumpstart.doublenegative.com.au/jumpstart/examples/lang/ifnotnegateswitchelseunless] -{float}</plain-text-body>In cases where you have to distinguish multiple cases, the <code>Delegate</code> component comes in. It delegates rendering to some other component, for example a <code>Block</code>. For each case you have, you basically wrap the content inside a <code>Block</code> that doesn't get rendered by default. You then place a Delegate component on your page and point it to a method inside your page class that will decide which of your Blocks should be rendered.</p><p>Imagine for example a use case, where you want to distinguish between 4 cases and you have an int property called <code>whichCase</code> that should be tested against. Your page template would look as follows:</p><parameter ac:name="language">xml</parameter><parameter ac:name="title">SwitchMe.tml</parameter><plain-text-body><html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd"> + <div id="ConfluenceContent"><p> </p><h1 id="SwitchingCases-SwitchingCases">Switching Cases</h1><p>With Tapestry's <code>If</code> component you can only test one condition at a time. In order to distinguish multiple cases, you'd have to write complex nested if/else constructs in your page template and have a checker method for each test inside your page class.</p><div class="navmenu" style="float:right; background:#eee; margin:3px; padding:0 1em"> +<p> <strong>JumpStart Demo:</strong><br clear="none"> + <a class="external-link" href="http://jumpstart.doublenegative.com.au/jumpstart/examples/lang/ifnotnegateswitchelseunless"; rel="nofollow">If, Not, Negate, Switch, Else, Unless</a></p></div>In cases where you have to distinguish multiple cases, the <code>Delegate</code> component comes in. It delegates rendering to some other component, for example a <code>Block</code>. For each case you have, you basically wrap the content inside a <code>Block</code> that doesn't get rendered by default. You then place a Delegate component on your page and point it to a method inside your page class that will decide which of your Blocks should be rendered.<p>Imagine for example a use case, where you want to distinguish between 4 cases and you have an int property called <code>whichCase</code> that should be tested against. Your page template would look as follows:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"> <b>SwitchMe.tml</b></div><div class="codeContent panelContent pdl"> +<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd"> <body> <h1>Switch</h1> @@ -93,7 +103,9 @@ </t:block> </body> </html> -</plain-text-body><p>You can see, that the <code>Delegate</code> component's <code>to</code> parameter is bound to the case property of your page class. In your page class you therefore have a <code>getCase()</code> method that is responsible for telling the <code>Delegate</code> component which component should be rendered. For that we are injecting references to the <code>Block}}s defined in your page template into the page class and return the according {{Block</code> in the <code>getCase()</code> method.</p><parameter ac:name="language">java</parameter><parameter ac:name="title">SwitchMe.java</parameter><plain-text-body>public class SwitchMe +</pre> +</div></div><p>You can see, that the <code>Delegate</code> component's <code>to</code> parameter is bound to the case property of your page class. In your page class you therefore have a <code>getCase()</code> method that is responsible for telling the <code>Delegate</code> component which component should be rendered. For that we are injecting references to the <code>Block}}s defined in your page template into the page class and return the according {{Block</code> in the <code>getCase()</code> method.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>SwitchMe.java</b></div><div class="codeContent panelContent pdl"> +<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">public class SwitchMe { @Persist private int whichCase; @@ -118,7 +130,8 @@ } } } -</plain-text-body><p>Happy switching!</p></div> +</pre> +</div></div><p>Happy switching!</p></div> </div> <div class="clearer"></div>
![http://tapestry.apache.org/images/tapestry_small.png"](http://tapestry.apache.org/images/tapestry_small.png"){kind=link}