You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by bu...@apache.org on 2013/02/09 13:20:54 UTC

svn commit: r850009 - in /websites/production/tapestry/content: cache/main.pageCache component-parameters.html documentation.html

Author: buildbot
Date: Sat Feb  9 12:20:53 2013
New Revision: 850009

Log:
Production update by buildbot for tapestry

Modified:
    websites/production/tapestry/content/cache/main.pageCache
    websites/production/tapestry/content/component-parameters.html
    websites/production/tapestry/content/documentation.html

Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/tapestry/content/component-parameters.html
==============================================================================
--- websites/production/tapestry/content/component-parameters.html (original)
+++ websites/production/tapestry/content/component-parameters.html Sat Feb  9 12:20:53 2013
@@ -380,7 +380,9 @@
 
 <h1><a shape="rect" name="ComponentParameters-InformalParameters"></a>Informal Parameters</h1>
 
-<p>Some components support <em>informal parameters</em>, additional parameters beyond the formally defined parameters. Informal parameters will be rendered into the output as additional attributes on the tag rendered by the component. Generally speaking, components that have a 1:1 relationship with a particular HTML tag (such as &lt;TextField&gt; and &lt;input&gt; will support informal parameters.</p>
+<p>Main Article: <a shape="rect" href="supporting-informal-parameters.html" title="Supporting Informal Parameters">Supporting Informal Parameters</a></p>
+
+<p>Many components support <em>informal parameters</em>, additional parameters beyond the formally defined parameters. Informal parameters will be rendered into the output as additional attributes on the tag rendered by the component. Generally speaking, components that have a 1:1 relationship with a particular HTML tag (such as &lt;TextField&gt; and &lt;input&gt; will support informal parameters.</p>
 
 <p>Only components whose class is annotated with @<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/annotations/SupportsInformalParameters.html">SupportsInformalParameters</a> will support informal parameters. Tapestry silently drops informal parameters that are specified for components that do not have this annotation.</p>
 
@@ -388,6 +390,8 @@
 
 <p>The default binding prefix for informal parameters depends on <em>where</em> the parameter binding is specified. If the parameter is bound inside a Java class, within the @<a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/annotations/Component.html">Component</a> annotation, then the default binding prefix is "prop:". If the parameter is bound inside the component template, then the default binding prefix is "literal:". This reflects the fact that a parameter specified in the Java class, using the annotation, is most likely a computed value, whereas a value in the template should simply be copied, as is, into the result HTML stream.</p>
 
+<p>Informal parameters (if supported) are always rendered into the output <em>unless</em> they are bound to a property whose value is null. If the bound property is null then the parameter will <em>not</em> be present at all in the rendered output.</p>
+
 <p>If your component should render informal parameters, just inject the <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/ComponentResources.html">ComponentResources</a> for your component and invoke the <tt>renderInformalParameters()</tt> method. See <a shape="rect" href="supporting-informal-parameters.html" title="Supporting Informal Parameters">Supporting Informal Parameters</a> for an example of how to do this.</p>
 
 <h1><a shape="rect" name="ComponentParameters-ParametersAreBiDirectional"></a>Parameters Are Bi-Directional</h1>

Modified: websites/production/tapestry/content/documentation.html
==============================================================================
--- websites/production/tapestry/content/documentation.html (original)
+++ websites/production/tapestry/content/documentation.html Sat Feb  9 12:20:53 2013
@@ -73,11 +73,11 @@
 <h1><a shape="rect" name="Documentation-APIandComponentReference"></a>API and Component Reference</h1>
 
 <div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> API (Javadoc): </th><td colspan="1" rowspan="1" class="confluenceTd"> 5.0 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.1 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.2 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/">5.3.x (current)</a> </td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"> Component Reference: </th><td colspan="1" rowspan="1" class="confluenceTd"> 5.0 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.1 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.2 <sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="component-reference.html" title="Component Reference">5.3.x (current)</a> </td></tr><tr><th colspan="1" rowspan="1" class="c
 onfluenceTh"> Release Notes: </th><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-50.html" title="Release Notes 5.0">5.0</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-51.html" title="Release Notes 5.1">5.1</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-52.html" title="Release Notes 5.2">5.2</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes.html" title="Release Notes">5.3.x (current)</a> </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> API (Javadoc): </th><td colspan="1" rowspan="1" class="confluenceTd"> 5.0<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.1<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.2<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/">5.3.x (current)</a> </td></tr><tr><th colspan="1" rowspan="1" class="confluenceTh"> Component Reference: </th><td colspan="1" rowspan="1" class="confluenceTd"> 5.0<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.1<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> 5.2<sup>1</sup> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="component-reference.html" title="Component Reference">5.3.x (current)</a> </td></tr><tr><th colspan="1" rowspan="1" class="conflue
 nceTh"> Release Notes: </th><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-50.html" title="Release Notes 5.0">5.0</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-51.html" title="Release Notes 5.1">5.1</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes-52.html" title="Release Notes 5.2">5.2</a> </td><td colspan="1" rowspan="1" class="confluenceTd"> <a shape="rect" href="release-notes.html" title="Release Notes">5.3.x (current)</a> </td></tr></tbody></table>
 </div>
 
 
-<p><sup>1</sup> needs to be build manually from archived sources at <a shape="rect" class="external-link" href="http://archive.apache.org/dist/tapestry/">http://archive.apache.org/dist/tapestry/</a>.</p>
+<p><sup>1</sup> needs to be built manually from archived sources at <a shape="rect" class="external-link" href="http://archive.apache.org/dist/tapestry/">http://archive.apache.org/dist/tapestry/</a>.</p>
 
 <h1><a shape="rect" name="Documentation-UserGuide"></a>User Guide</h1>