You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by ek...@apache.org on 2005/05/19 21:28:45 UTC
svn commit: r170981 [1/3] - in
/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding:
bundle/ cellrepeater/ datagrid/ invoke/ message/ pageinput/ repeater/
repeater/pad/ script/ xml/
Author: ekoneil
Date: Thu May 19 12:28:44 2005
New Revision: 170981
URL: http://svn.apache.org/viewcvs?rev=170981&view=rev
Log:
Databinding tag Javadoc cleanup.
- made lots of the tagref and class doc consistent and the same
- cleaned up un-escaped angle brackets in lots of the sample code
BB: self
DRT: Beehive pass / build.dist pass
BVT: NetUI pass
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/AnchorCell.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/DataGrid.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/GetDataGridState.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Header.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageAnchorCell.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Rows.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/SpanCell.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/TemplateCell.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallMethod.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallPageFlow.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/MethodParameter.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/ObjectNotFoundException.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/Message.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/MessageArg.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/pageinput/DeclarePageInput.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/Repeater.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterComponent.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterFooter.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterHeader.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterItem.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/pad/Pad.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/script/GetData.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/xml/SerializeXML.java
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java Thu May 19 12:28:44 2005
@@ -17,94 +17,141 @@
*/
package org.apache.beehive.netui.tags.databinding.bundle;
-import org.apache.beehive.netui.tags.AbstractClassicTag;
-import org.apache.beehive.netui.util.Bundle;
-import org.apache.beehive.netui.script.common.BundleMap;
-
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TryCatchFinally;
import javax.servlet.http.HttpServletRequest;
import java.util.Locale;
+import org.apache.beehive.netui.tags.AbstractClassicTag;
+import org.apache.beehive.netui.util.Bundle;
+import org.apache.beehive.netui.script.common.BundleMap;
+
/**
- * <p>A tag used to declare a {@link java.util.ResourceBundle} that can be used inside of the declaring
- * page as a source for displaying internationalized messages. The declared resource bundle is accessible
- * using the <code>bundle</code> implicit object. The required <code>name</code> attribute specifies
- * the identifier via which to refer to the ResourceBundle in an expression. For example:</p>
+ * <p>Declares a {@link java.util.ResourceBundle java.util.ResourceBundle} as a source for displaying internationalized
+ * messages. The declared resource bundle is accessible using the <code>${bundle...}</code> data binding context.
+ * The required <code>name</code> attribute specifies the identifier used to refer to the ResourceBundle in an expression.
+ * For example:
+ * <br/>
* <pre>
- * <netui-data:declareBundle name="someMessages" bundlePath="com/foobar/resources/WebAppMessages"/>
+ * <netui-data:declareBundle name="someMessages" bundlePath="com/foobar/resources/WebAppMessages"/>
* </pre>
- * <p>This tag declares a bundle that is referenced in a data binding expression as
- * <code>${bundle.someMessages}</code>.</p>
- * <p>The bundle that is referenced depends on the Locale specified, see below. The resource bundle properties
- * files that are accessed are located in the package <code>com/foobar/resources</code> with the root
- * properties file name of <code>WebAppMessages</code>. The naming conventions for properties can be found
- * in {@link java.util.ResourceBundle#getBundle(String, Locale, ClassLoader)}. These files must be located
- * in a classpath that is available to the web application; often, this is WEB-INF/classes.
- * If the properties file contains a key called <code>helloWorld</code>,
- * then the expression <code>${bundle.someMessages.helloWorld}</code>
- * would be look-up the message matching the Locale specified on the tag. Bundle binding expressions can be
- * used in any expression bindable NetUI tag attribute.</p>
- * <p>Note, the name <code>default</code> is a bundle identifier that is reserved for use by the
- * DeclareBundle tag. If this value is used for the <code>name</code> attribute on a DeclareBundle tag,
- * an error will be reported in the page. The <code>default</code> bundle is reserved for use when
- * accessing internationalized messages from the "current" Struts module's default properties file.</p>
- * <p>This tag provides a high level of customizability for rendering internationalized messages.
- * Specifically, the {@link Locale} for which to look-up messages can be specified on the DeclareBundle
+ * <p>
+ * This tag declares a bundle that is referenced in a data binding expression as <code>${bundle.someMessages}</code>.
+ * </p>
+ * <p>
+ * The bundle that is referenced depends on the
+ * <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html" target="_blank">java.util.Locale</a>
+ * specified. The resource bundle properties files that are accessed are located
+ * in the package <code>com/foobar/resources</code> with the root properties file
+ * name of <code>WebAppMessages</code>. The naming conventions for properties can
+ * be found in Sun's Java documentation at
+ * <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/ResourceBundle.html#getBundle(java.lang.String, java.util.Locale, java.lang.ClassLoader)" target="_blank">ResourceBundle.getBundle(String,Locale, ClassLoader)</a> .
+ * These files must be located in a classpath that is available to the web application. Often, they are stored in
+ * <code>WEB-INF/classes</code>. If the properties file contains a key called <code>helloWorld</code>, then the
+ * expression <code>${bundle.someMessages.helloWorld}</code> would look-up the message
+ * matching the Locale specified on the tag. Bundle binding expressions can be
+ * used in any data bindable <netui...> tag attribute.
+ * </p>
+ * <p>It is possible to have keys that contain multiple words separated by spaces, commas, or periods. If this is the
+ * case, then you must use slightly differente syntax to reference those keys in your data binding statement. The
+ * following list illustrates three ways to access the key <code>My helloWorld</code> from the
+ * <code>someMessages</code> property file:
+ * </p>
+ * <ul>
+ * <li><code><netui:span value="${bundle.someMessages['My helloWorld']}"/></code></li>
+ * <li><code><netui:span value='${bundle.someMessages["My helloWorld"]}'/></code></li>
+ * <li><code><netui:span value="${bundle.someMessages[\"My helloWorld\"]}"/></code></li>
+ * </ul>
+ * <p>
+ * <b>Note:</b> the name <code>default</code> is a bundle identifier that is reserved for use by the
+ * <netui-data:declareBundle> tag. If this value is used for the <code>name</code> attribute on a
+ * <netui-data:declareBundle> tag, an error will be reported in the page. The <code>default</code> bundle
+ * is reserved for use when accessing internationalized messages from the "current" Struts module's
+ * default properties file.</p>
+ * <p/>
+ * <p>
+ * This tag provides a high level of customizability for rendering internationalized messages. Specifically, the
+ * {@link Locale} for which to look-up messages can be specified on the <netui-data:declareBundle>
* tag. By default, the Locale for the current request is used, but this Locale can be overridden by
* setting the <code>language</code>, <code>country</code>, and <code>variant</code> tag attributes
- * as necessary. See {@link Locale} for more information on the possible values for these attributes.</p>
+ * as necessary. See java.util.Locale for more information on the possible values for these attributes.</p>
* <p>The Locale can be overridden by setting these attributes in three combinations:</p>
+ * <blockquote>
* <ul>
* <li>country, language, variant</li>
* <li>country, language</li>
* <li>country</li>
* </ul>
- * <p>Any other combinations will throw an exception.</p>
- *
- * @jsptagref.tagdescription <p>Declares a {@link java.util.ResourceBundle java.util.ResourceBundle}
- * as a source for displaying internationalized messages.
- * The declared resource bundle is accessible
- * using the <code>${bundle...}</code> data binding context.
- * The required <code>name</code> attribute specifies
- * the identifier used to refer to the ResourceBundle in an expression. For example:</p>
+ * </blockquote>
+ * Any other combinations will throw an exception.
+ * </p>
+ * <p>The <netui-data:declareBundle> tag and the Struts <i18n:getMessage> tags have the following differences.
+ * The <netui-data:declareBundle> tag lets you customize the use of a particular resource bundle with attributes
+ * to set the country, language, and variant explicitly, but it does not write a message out to the JSP page.
+ * Writing out a message from this bundle is done inside of any of the other tags using the <code>bundle</code>
+ * JSP EL implicit object.
+ * <p/>
+ * <pre>
+ * <netui:span value="<b>${bundle.messages.messageKey}</b>"/>
+ * </pre>
* <p/>
- * <pre> <netui-data:declareBundle name="someMessages" bundlePath="com/foobar/resources/WebAppMessages"/></pre>
+ * <p>The Struts <i18n:getMessage> tag is used to access a bundle <i>and</i> write the message out. It
+ * is roughly equivalent to doing the following:
* <p/>
- * <p>This tag declares a bundle that is referenced in a data binding expression as
- * <code>${bundle.someMessages}</code>.</p>
+ * <pre>
+ * <netui-data:declareBundle bundlePath="com/foobar/resources/messages" name="messages"/>
+ * <netui:span value="${bundle.messages.messageKey}"/></pre>
* <p/>
- * <p>The bundle that is referenced depends on the <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html" target="_blank">java.util.Locale</a>
+ * <p>An advantage of using the ${bundle...} data binding context, is that it lets you write into the
+ * <span>...</span> that the <netui:span> creates, or into a <neuti:checkBox> name, etc.
+ * just like using a regular String.
+ *
+ * @jsptagref.tagdescription
+ * <p>Declares a {@link java.util.ResourceBundle java.util.ResourceBundle} as a source for displaying internationalized
+ * messages. The declared resource bundle is accessible using the <code>${bundle...}</code> data binding context.
+ * The required <code>name</code> attribute specifies the identifier used to refer to the ResourceBundle in an expression.
+ * For example:
+ * <br/>
+ * <pre>
+ * <netui-data:declareBundle name="someMessages" bundlePath="com/foobar/resources/WebAppMessages"/>
+ * </pre>
+ * <p>
+ * This tag declares a bundle that is referenced in a data binding expression as <code>${bundle.someMessages}</code>.
+ * </p>
+ * <p>
+ * The bundle that is referenced depends on the
+ * <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.html" target="_blank">java.util.Locale</a>
* specified. The resource bundle properties files that are accessed are located
* in the package <code>com/foobar/resources</code> with the root properties file
* name of <code>WebAppMessages</code>. The naming conventions for properties can
- * be found in Sun's Java documentation at <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/ResourceBundle.html#getBundle(java.lang.String, java.util.Locale, java.lang.ClassLoader)" target="_blank">ResourceBundle.getBundle(String,
- * Locale, ClassLoader)</a> . These files must be located in a classpath that is
- * available to the web application. Often, they are stored in <code>WEB-INF/classes</code>.
- * If the properties file contains a key called <code>helloWorld</code>, then the
+ * be found in Sun's Java documentation at
+ * <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/ResourceBundle.html#getBundle(java.lang.String, java.util.Locale, java.lang.ClassLoader)" target="_blank">ResourceBundle.getBundle(String,Locale, ClassLoader)</a> .
+ * These files must be located in a classpath that is available to the web application. Often, they are stored in
+ * <code>WEB-INF/classes</code>. If the properties file contains a key called <code>helloWorld</code>, then the
* expression <code>${bundle.someMessages.helloWorld}</code> would look-up the message
* matching the Locale specified on the tag. Bundle binding expressions can be
- * used in any data bindable <netui...> tag attribute.</p>
+ * used in any data bindable <netui...> tag attribute.
+ * </p>
* <p>It is possible to have keys that contain multiple words separated by spaces,
* commas, or periods. If this is the case, then you must use slightly different
* syntax to reference those keys in your data binding statement. The following
* list illustrates three ways to access the key <code>My helloWorld</code> from the <code>someMessages</code>
- * property file:</p>
+ * property file:
+ * </p>
* <ul>
- * <li><code><netui:span value="${bundle.someMessages['My helloWorld']}"/></code>
- * </li>
- * <li><code><netui:span value='${bundle.someMessages["My helloWorld"]}'/></code>
- * </li>
- * <li><code><netui:span value="${bundle.someMessages[\"My helloWorld\"]}"/></code><br>
- * </li>
+ * <li><code><netui:span value="${bundle.someMessages['My helloWorld']}"/></code></li>
+ * <li><code><netui:span value='${bundle.someMessages["My helloWorld"]}'/></code></li>
+ * <li><code><netui:span value="${bundle.someMessages[\"My helloWorld\"]}"/></code></li>
* </ul>
- * <p><b>Note:</b> the name <code>default</code> is a bundle identifier that is reserved for use by the
+ * <p>
+ * <b>Note:</b> the name <code>default</code> is a bundle identifier that is reserved for use by the
* <netui-data:declareBundle> tag. If this value is used for the <code>name</code> attribute on a
* <netui-data:declareBundle> tag,
* an error will be reported in the page. The <code>default</code> bundle is reserved for use when
* accessing internationalized messages from the "current" Struts module's default properties file.</p>
* <p/>
- * <p>This tag provides a high level of customizability for rendering internationalized messages.
+ * <p>
+ * This tag provides a high level of customizability for rendering internationalized messages.
* Specifically, the Locale for which to look-up messages can be specified on the
* <netui-data:declareBundle>
* tag. By default, the Locale for the current request is used, but this Locale can be overridden by
@@ -118,16 +165,13 @@
* <li>country</li>
* </ul>
* </blockquote>
- * <p>Any other combinations will throw an exception.</p>
- * <p/>
- * <p>The <netui-data:declareBundle> tag and the Struts <i18n:getMessage> tags have
- * the following differences. The <netui-data:declareBundle> tag lets you
- * customize the use
- * of a particular resource bundle with attributes to set the country,
- * language, and variant explicitly, but it does not write a message out to the
- * JSP page.
- * Writing out a message from this bundle is done inside of any of the
- * other tags using the <code>bundle</code> implicit object.
+ * Any other combinations will throw an exception.
+ * </p>
+ * <p>The <netui-data:declareBundle> tag and the Struts <i18n:getMessage> tags have the following differences.
+ * The <netui-data:declareBundle> tag lets you customize the use of a particular resource bundle with attributes
+ * to set the country, language, and variant explicitly, but it does not write a message out to the JSP page.
+ * Writing out a message from this bundle is done inside of any of the other tags using the <code>bundle</code>
+ * JSP EL implicit object.
* <p/>
* <pre> <netui:span value="<b>${bundle.messages.messageKey}</b>"/></pre>
* <p/>
@@ -138,11 +182,12 @@
* <netui-data:declareBundle bundlePath="com/foobar/resources/messages" name="messages"/>
* <netui:span value="${bundle.messages.messageKey}"/></pre>
* <p/>
- * <p>An advantage of using the ${bundle...} data binding context, is that it lets you
- * write into the <span>...</span> that the <netui:span>
- * creates, or into a <neuti:checkBox> name, etc. just like using a regular String.
+ * <p>An advantage of using the ${bundle...} data binding context, is that it lets you write into the
+ * <span>...</span> that the <netui:span> creates, or into a <neuti:checkBox> name, etc.
+ * just like using a regular String.
*
- * @netui:tag name="declareBundle" description="Use this tag to declare a resource bundle that is available in the bundle databinding context"
+ * @netui:tag name="declareBundle"
+ * description="Use this tag to declare a resource bundle that is available in the bundle databinding context"
*/
public class DeclareBundle
extends AbstractClassicTag
@@ -165,14 +210,15 @@
}
/**
- * Set the language to use when looking-up resource bundle messages. This value
- * is used to further specify the name of the .properties file message
- * keys will be read from.
+ * Set the language to use when looking-up resource bundle messages.
+ * The two-letter lowercase ISO-639 language code for the Locale from which to look-up resource bundle messages.
+ * This value is used to further specify the name of the .properties file from which message keys will be read.
*
* @param language the two-letter lowercase ISO-639 code for a language.
- * @jsptagref.attributedescription The two-letter lowercase ISO-639 language code for the Locale from which to look-up resource bundle messages.
+ * @jsptagref.attributedescription
+ * Set the language to use when looking-up resource bundle messages.
+ * The two-letter lowercase ISO-639 language code for the Locale from which to look-up resource bundle messages.
* This value is used to further specify the name of the .properties file from which message keys will be read.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>string_language</i>
* @netui:attribute required="false" rtexprvalue="true"
*/
@@ -181,16 +227,15 @@
}
/**
- * Set the country to use when looking-up resource bundle messages. This value
- * is used to further specify the name of the .properties file message
- * keys will be read from.
+ * Set the country to use when looking-up resource bundle messages. The two-letter uppercase ISO-3166
+ * country / region code for the Locale from which to look-up resource bundle messages. This value is used to
+ * further specify the name of the .properties file from which message keys will be read.
*
* @param country the two-letter uppercase ISO-3166 code for a country
- * @jsptagref.attributedescription The two-letter uppercase ISO-3166 country / region code for the
- * Locale from which to look-up resource bundle messages.
- * This value is used to further specify the name of the
- * .properties file from which message keys will be read.
- * @jsptagref.databindable true
+ * @jsptagref.attributedescription
+ * Set the country to use when looking-up resource bundle messages. The two-letter uppercase ISO-3166
+ * country / region code for the Locale from which to look-up resource bundle messages. This value is used to
+ * further specify the name of the .properties file from which message keys will be read.
* @jsptagref.attributesyntaxvalue <i>string_country</i>
* @netui:attribute required="false" rtexprvalue="true"
*/
@@ -199,12 +244,11 @@
}
/**
- * Set the vendor / browser specific code that further parameterizes the
- * .properties file messages will be read from.
+ * Sets a vendor / browser specific code for further parameterizign the Locale from which to look-up resource bundle messages.
*
* @param variant the variant
- * @jsptagref.attributedescription A vendor / browser specific code for further parameterizign the Locale from which to look-up resource bundle messages.
- * @jsptagref.databindable true
+ * @jsptagref.attributedescription
+ * Sets a vendor / browser specific code for further parameterizign the Locale from which to look-up resource bundle messages.
* @jsptagref.attributesyntaxvalue <i>string_variant</i>
* @netui:attribute required="false" rtexprvalue="true"
*/
@@ -213,14 +257,13 @@
}
/**
- * Set the name via which this bundle can be accessed using the <code>bundle</code>
- * databinding context. The identifier <code>default</code> is an illegal value
- * for this attribute and is reserved for use by this tag.
+ * The name inside of the ${bundle...} databinding context under which the properties in this bundle are available.
+ * The identifier <code>default</code> is an illegal value for this attribute and is reserved for use by this tag.
*
* @param name the name of the bundle
- * @jsptagref.attributedescription The name inside of the {bundle...} databinding context under which the properties in this bundle are available.
+ * @jsptagref.attributedescription
+ * The name inside of the ${bundle...} databinding context under which the properties in this bundle are available.
* The identifier <code>default</code> is an illegal value for this attribute and is reserved for use by this tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_name</i>
* @netui:attribute required="true"
*/
@@ -229,21 +272,24 @@
}
/**
- * Set the path to the resource bundle's properties files. This can be a slash
- * or dot delimited classpath. Valid values might be:
+ * Set the path to the resource bundle's properties files. This can be a slash or dot delimited classpath.
+ * Valid values should appear as:
+ * <blockquote>
* <ul>
* <li>com/foobar/resources/WebAppProperties</li>
* <li>com.foobar.resources.WebAppProperties</li>
* </ul>
- * These are treated as equivalent values. The {@link java.util.ResourceBundle} class
+ * </blockquote>
+ * <p>These are treated as equivalent values. The {@link java.util.ResourceBundle} class
* will handle appending the <code>.properties</code> file type and locale information
* as necessary. See {@link java.util.ResourceBundle#getBundle(String, Locale, ClassLoader)}
* for the <code>.properties</code> file naming conventions. These files must be available in
* classpath for the webapp in order to be successfully located.
*
* @param bundlePath the path to the bundle's properties files.
- * @jsptagref.attributedescription Set the path to the resource bundle's properties files. This can be a slash
- * or dot delimited classpath. Valid values might be:
+ * @jsptagref.attributedescription
+ * Set the path to the resource bundle's properties files. This can be a slash or dot delimited classpath.
+ * Valid values should appear as:
* <blockquote>
* <ul>
* <li>com/foobar/resources/WebAppProperties</li>
@@ -255,7 +301,6 @@
* as necessary. See {@link java.util.ResourceBundle#getBundle(String, Locale, ClassLoader)}
* for the <code>.properties</code> file naming conventions. These files must be available in
* classpath for the webapp in order to be successfully located.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_bundlePath</i>
* @netui:attribute required="true"
*/
@@ -266,7 +311,7 @@
/**
* Start the JSP rendering lifecycle for this tag; it skips its body.
*
- * @return {@link javax.servlet.jsp.tagext.Tag#SKIP_BODY}
+ * @return {@link #SKIP_BODY}
*/
public int doStartTag() {
return SKIP_BODY;
@@ -277,7 +322,7 @@
* during the execution of this tag will be reported in the page, which will continue
* rendering.
*
- * @return {@link javax.servlet.jsp.tagext.Tag#EVAL_PAGE}
+ * @return {@link #EVAL_PAGE}
* @throws JspException if error conditions are encountered during this method which can not
* be reported in the page.
*/
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java Thu May 19 12:28:44 2005
@@ -45,46 +45,38 @@
/**
* <p/>
- * The CellRepeater tag is a repeating, databound tag that renders
- * its body each cell of a table of the specified dimensions. The tag
- * is bound to a dataset that is specified in the <code>dataSource</code>
- * attribute. For each item in the data set, the body of this tag is rendered,
- * and NetUI tags in the body that are databound can use the <code>container.item</code>
- * syntax to access the "current" data item in the iteration. Properties
- * on this data item can be accessed using expressions.
- * </p><p>
- * The tag will automatically insert the open and close table, row, and cell
- * tags which will comprise the table that is rendered. Style attributes may
- * be set using attributes on this tag in order to cusotmize the tag's final
- * appearance. The dimensions of the table are specified by using at least
- * one of the attributes columns and rows. If only one is specified, the other
- * will be inferred by using the size of the given data set. As a result, the
- * entire dataset will be rendered. For example,
- * if a table should be four columns wide and the data set has twenty items,
- * the resulting table will have five rows. If the data set is fewer items than
- * the number of cells that should be rendered, the cells are padded with HTML table
- * cells:
+ * This tag is a repeating, databound tag that renders its body each cell of a table of the specified dimensions.
+ * The tag is bound to a dataset that is specified in the <code>dataSource</code> attribute. For each item in
+ * the data set, the body of this tag is rendered, and NetUI tags in the body that are databound
+ * can use the <code>container.item</code> syntax to access the "current" data item in the iteration.
+ * Properties on this data item can be accessed using expressions.
+ * </p>
+ * <p>
+ * The tag will automatically insert the open and close table, row, and cell tags which will comprise
+ * the table that is rendered. Style attributes may be set using attributes on this tag in order to
+ * cusotmize the tag's final appearance. The dimensions of the table are specified by using at least
+ * one of the attributes columns and rows. If only one is specified, the other will be inferred by
+ * using the size of the given data set. As a result, the entire dataset will be rendered. For example,
+ * if a table should be four columns wide and the data set has twenty items, the resulting table will
+ * have five rows. If the data set is fewer items than the number of cells that should be rendered,
+ * the cells are padded with HTML table cells:
* </p>
* <pre>
* <td>&nbsp;</td>
* </pre>
* <p/>
- * This will prevent rendering a malformed HTML table. If the number of cells
- * to render is smaller than the fully specified dimensions of the table, only
- * this number of cells will be rendered. For example, if the data set is size fifty
- * but the <code>rows</code> and the <code>columns</code> attributes are both seven,
- * only the first forty-nine items in the dataset will be rendered and the fiftieth
- * will not be shown. The values of the <code>rows</code> and the <code>columns</code>
- * can be databound with an expression; in this case, each value will be
- * converted into an integer. An error will be reported on the page if this conversion
- * fails.
+ * This will prevent rendering a malformed HTML table. If the number of cells to render is smaller than
+ * the fully specified dimensions of the table, only this number of cells will be rendered. For example,
+ * if the data set is size fifty but the <code>rows</code> and the <code>columns</code> attributes are
+ * both seven, only the first forty-nine items in the dataset will be rendered and the fiftieth
+ * will not be shown. The values of the <code>rows</code> and the <code>columns</code> can be databound with
+ * an expression; in this case, each value will be converted into an integer. An error will be reported
+ * on the page if this conversion fails.
* </p><p>
- * This tag implements the {@link IDataAccessProvider}
- * interface which provides tags access to the "current" data item. Properties
- * on the <code>IDataAccessProvider</code> interface are available through the
- * "container" binding context, which can be used inside of the body of the
- * CellRepeater. Properties of the <code>IDataAccessProvider</code> interface
- * that are available include:
+ * This tag implements the {@link IDataAccessProvider} interface which provides tags access to the "current"
+ * data item. Properties on the <code>IDataAccessProvider</code> interface are available through the
+ * "container" binding context, which can be used inside of the body of the CellRepeater. Properties of
+ * the <code>IDataAccessProvider</code> interface that are available include:
* <table border="1" cellspacing="0" cellpadding="5" width="75%">
* <tr><td><b>Name</b></td><td><b>Description</b></td></tr>
* <tr><td>index</td><td>the current index in the iteration; this index is absolute to the dataset</td></tr>
@@ -97,53 +89,63 @@
* on the CellRepeater.
* </p>
*
- * @jsptagref.tagdescription <p>
- * Renders individual cells of an HTML table. The tag
- * is data bound to a data set specified in the <code>dataSource</code>
- * attribute. Other <netui...> tags in the body of <netui-data:cellRepeater>
- * can use the expression <code>{container.item}</code>
- * to access the current data item in the data set.</p>
+ * @jsptagref.tagdescription
* <p/>
- * <p/>
- * The tag will automatically generate the open and close table, row, and cell
- * tags. Style attributes may be set using attributes on this tag in order to customize
- * the rendered table's final appearance. The dimensions of the table are specified with
- * the attributes <code>columns</code> and <code>rows</code>. If only one dimension is specified, the other
- * will be inferred by using the size of the given data set. As a result, the entire dataset will be rendered.
- * For example, if the <code>columns</code> attribute is set to 4 and the data set has 20 items,
- * the resulting table will have 5 rows. If the data set has fewer items than the number of cells that should
- * be rendered, the cells are padded with HTML table cells:
+ * This tag is a repeating, databound tag that renders its body each cell of a table of the specified dimensions.
+ * The tag is bound to a dataset that is specified in the <code>dataSource</code> attribute. For each item in
+ * the data set, the body of this tag is rendered, and NetUI tags in the body that are databound
+ * can use the <code>container.item</code> syntax to access the "current" data item in the iteration.
+ * Properties on this data item can be accessed using expressions.
* </p>
- * <p/>
- * <pre> <td>&nbsp;</td></pre>
- * <p/>
- * <p/>
- * This will prevent rendering a malformed HTML table. If the number of cells
- * to render is smaller than the fully specified dimensions of the table, only
- * this number of cells will be rendered. For example, if the data set 50 items
- * but the <code>rows</code> and the <code>columns</code> attributes are both 7,
- * only the first 49 items in the dataset will be rendered and the 50th
- * will not be shown. The values of the <code>rows</code> and the
- * <code>columns</code>
- * can take a data binding expression; in this case, each value will be
- * converted into an integer.
- * An error will be reported on the page if this conversion
- * fails.
+ * <p>
+ * The tag will automatically insert the open and close table, row, and cell tags which will comprise
+ * the table that is rendered. Style attributes may be set using attributes on this tag in order to
+ * cusotmize the tag's final appearance. The dimensions of the table are specified by using at least
+ * one of the attributes columns and rows. If only one is specified, the other will be inferred by
+ * using the size of the given data set. As a result, the entire dataset will be rendered. For example,
+ * if a table should be four columns wide and the data set has twenty items, the resulting table will
+ * have five rows. If the data set is fewer items than the number of cells that should be rendered,
+ * the cells are padded with HTML table cells:
* </p>
+ * <pre>
+ * <td>&nbsp;</td>
+ * </pre>
* <p/>
+ * This will prevent rendering a malformed HTML table. If the number of cells to render is smaller than
+ * the fully specified dimensions of the table, only this number of cells will be rendered. For example,
+ * if the data set is size fifty but the <code>rows</code> and the <code>columns</code> attributes are
+ * both seven, only the first forty-nine items in the dataset will be rendered and the fiftieth
+ * will not be shown. The values of the <code>rows</code> and the <code>columns</code> can be databound with
+ * an expression; in this case, each value will be converted into an integer. An error will be reported
+ * on the page if this conversion fails.
+ * </p><p>
+ * This tag implements the {@link IDataAccessProvider} interface which provides tags access to the "current"
+ * data item. Properties on the <code>IDataAccessProvider</code> interface are available through the
+ * "container" binding context, which can be used inside of the body of the CellRepeater. Properties of
+ * the <code>IDataAccessProvider</code> interface that are available include:
+ * <table border="1" cellspacing="0" cellpadding="5" width="75%">
+ * <tr><td><b>Name</b></td><td><b>Description</b></td></tr>
+ * <tr><td>index</td><td>the current index in the iteration; this index is absolute to the dataset</td></tr>
+ * <tr><td>parent</td><td>any <code>IDataAccessProvider</code> parent of this tag</td></tr>
+ * <tr><td>item</td><td>the current data item</td></tr>
+ * </table>
+ * </p>
* <p/>
- * <b>Note:</b> the <code>metadata</code> property of the <code>{container...}</code> binding context is
- * not supported in the <netui-data:cellRepeater> tag.
+ * <b>Note:</b> the metadata property of the <code>container</code> binding context is not supported
+ * on the CellRepeater.
* </p>
- * @example In the following sample, the <netui-data:cellRepeater> tag creates a table with a
- * certain number of columns, as given in <code>${pageFlow.numColumns}</code> and as many
- * rows as necessary to display all the items in the data set.
+ *
+ * @example
+ * In this example, the <netui-data:cellRepeater> tag creates a table with the number of columns set
+ * given as <code>${pageFlow.numColumns}</code> and as many rows as necessary to display all the items in the
+ * <code>pageFlow.itemArray</code> data set.
* <pre>
* <netui-data:cellRepeater dataSource="pageFlow.itemArray" columns="pageFlow.numColumns">
* Item: <netui:span value="${container.item}"/>
* </netui-data:cellRepeater>
* </pre>
- * @netui:tag name="cellRepeater" description="A repeating, databound tag that renders its body into each cell of a table of the specified dimensions."
+ * @netui:tag name="cellRepeater"
+ * description="A repeating, databound tag that renders its body into each cell of a table of the specified dimensions."
*/
public class CellRepeater
extends AbstractClassicTag
@@ -190,20 +192,19 @@
}
/**
- * Set the HTML style class that is rendered on the HTML table that
- * is opened by this tag. For example, if the row class is "tableClass",
+ * The HTML style class that is rendered on the HTML table. For example, if the row class is "tableClass",
* each opening table tag is:
* <pre>
* <table class="tableClass">
* </pre>
*
* @param tableClass the name of a style class in a CSS
- * @jsptagref.attributedescription The HTML style class that is rendered on the HTML table.
- * For example, if the row class is "tableClass",
+ * @jsptagref.attributedescription
+ * The HTML style class that is rendered on the HTML table. For example, if the row class is "tableClass",
* each opening table tag is:
* <pre>
- * <table class="tableClass"></pre>
- * @jsptagref.databindable false
+ * <table class="tableClass">
+ * </pre>
* @jsptagref.attributesyntaxvalue <i>string_class</i>
* @netui:attribute required="false"
*/
@@ -223,12 +224,13 @@
* </pre>
*
* @param rowClass the name of a style class in the CSS
- * @jsptagref.attributedescription The HTML style class that is rendered on each HTML table row.
- * For example, if the row class is "rowClass",
+ * @jsptagref.attributedescription
+ * Set the HTML style class that is rendered on each HTML table row that
+ * is opened by this tag. For example, if the row class is "rowClass",
* each opening table row tag is:
* <pre>
- * <tr class="rowClass"></pre>
- * @jsptagref.databindable false
+ * <tr class="rowClass">
+ * </pre>
* @jsptagref.attributesyntaxvalue <i>string_class</i>
* @netui:attribute required="false"
*/
@@ -248,12 +250,13 @@
* </pre>
*
* @param cellClass the name of a style class in a CSS
- * @jsptagref.attributedescription The HTML style class that is rendered on each table cell.
- * For example, if the cell class is "cellClass",
+ * @jsptagref.attributedescription
+ * Set the HTML style class that is rendered on each HTML table cell that
+ * is opened by this tag. For example, if the cell class is "cellClass",
* each opening table cell tag is:
* <pre>
- * <td class="cellClass"></pre>
- * @jsptagref.databindable false
+ * <td class="cellClass">
+ * </pre>
* @jsptagref.attributesyntaxvalue <i>string_class</i>
* @netui:attribute required="false"
*/
@@ -274,14 +277,14 @@
* </pre>
*
* @param alternatingCellClass the name of a style class in a CSS
- * @jsptagref.attributedescription The HTML style class that is rendered on alternating table cells.
+ * @jsptagref.attributedescription
+ * The HTML style class that is rendered on alternating table cells.
* The starting cell is alternated for each row, which
* results in a checkerboard colored table being displayed. For example, if the
* alteranting cell class is "alternatingCellClass", every other table cell
* tag is:
* <pre>
* <td cell="alternatingCellClass"></pre>
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_class</i>
* @netui:attribute required="false"
*/
@@ -299,11 +302,11 @@
*
* @param verticalRepeat if set to <code>true</code>, the dataset is rendered down
* each column; otherwise it is rendered across each row, the default.
- * @jsptagref.attributedescription Boolean. If true the data set is rendered vertically, otherwise it is rendered horizontally. If
+ * @jsptagref.attributedescription
+ * Boolean. If true the data set is rendered vertically, otherwise it is rendered horizontally. If
* the rows are rendered horizontally, the items in the data set are rendered
* across each row from top to bottom. Otherwise, they are rendered down each
* column from left to right. The default is to render the items horizontally.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>boolean_verticalRepeat</i>
* @netui:attribute required="false"
*/
@@ -318,11 +321,11 @@
* using the size of the dataset.
*
* @param columns an integer or an expression
- * @jsptagref.attributedescription Integer. The number of columns that should be rendered in the HTML table.
+ * @jsptagref.attributedescription
+ * Integer. The number of columns that should be rendered in the HTML table.
* If the <code>columns</code> attribute is specified but
* the <code>rows</code> attribute is not, the <code>rows</code> attribute will be inferred
* using the size of the data set.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>integer_columns</i>
* @netui:attribute required="false" rtexprvalue="true"
*/
@@ -338,11 +341,11 @@
*
* @param rows an integer or an expression whose value can be
* converted into an integer.
- * @jsptagref.attributedescription Integer. The number of rows that should be rendered in the HTML table.
+ * @jsptagref.attributedescription
+ * Integer. The number of rows that should be rendered in the HTML table.
* If the <code>rows</code> attribute is specified but
* the <code>columns</code> attribute is not, the <code>columns</code> attribute will be
* inferred using the size of the data set.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>integer_rows</i>
* @netui:attribute required="false" rtexprvalue="true"
*/
@@ -351,9 +354,29 @@
}
/**
- * Sets the tag's data source.
- * @param dataSource - the data source
- * @jsptagref.attributedescription <p>The <code>dataSource</code> attribute determines both
+ * <p>The <code>dataSource</code> attribute determines both
+ * (1) the source of populating data for the tag and
+ * (2) the object to which the tag submits data.
+ *
+ * <p>For example, assume that the Controller file (= JPF file) contains
+ * a Form Bean with the property foo. Then the following <netui:textBox> tag will
+ * (1) draw populating data from the Form Bean's foo property and (2)
+ * submit user defined data to the same property.
+ *
+ * <p> <code><netui:textBox dataSource="actionForm.foo" /></code>
+ *
+ * <p>When the tag is used to submit data, the data binding expression must
+ * refer to a Form Bean property.
+ * In cases where the tag is not used to submit data, but is used for
+ * displaying data only, the data
+ * binding expression need not refer to a Form Bean property. For example,
+ * assume that myIterativeData is a member variable on
+ * the Controller file ( = JPF file). The following <netui-data:repeater>
+ * tag draws its data from myIterativeData.
+
+ * @param dataSource the data source
+ * @jsptagref.attributedescription
+ * <p>The <code>dataSource</code> attribute determines both
* (1) the source of populating data for the tag and
* (2) the object to which the tag submits data.
*
@@ -374,7 +397,6 @@
* tag draws its data from myIterativeData.
*
* <p> <code><netui-data:cellRepeater dataSource="pageFlow.myIterativeData"></code>
- * @jsptagref.databindable Read / Write
* @jsptagref.attributesyntaxvalue <i>expression_datasource</i>
* @netui:attribute required="true"
*/
@@ -383,14 +405,6 @@
}
/**
- * Gets the tag's data source (can be an expression).
- * @return the data source
- */
- public String getDataSource() {
- return "{" + _dataSource + "}";
- }
-
- /**
* Prepare to render the dataset that was specified in the dataSource attribute. The
* dataSource expression is evaluated and the table's dimensions are computed. If
* there is no data in the dataset but the rows and columns attributes were specified,
@@ -583,6 +597,14 @@
throw t;
}
+ /**
+ * Gets the tag's data source (can be an expression).
+ * @return the data source
+ */
+ public String getDataSource() {
+ return "{" + _dataSource + "}";
+ }
+
/**
* Get the index of the current iteration through the body of this tag. This
* data can be accessed using the expression <code>container.index</code>
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/AnchorCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/AnchorCell.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/AnchorCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/AnchorCell.java Thu May 19 12:28:44 2005
@@ -44,11 +44,11 @@
* the action must exist inside of the 'current' Page Flow with which the JSP is associated. If the href is provided,
* the anchor will use this value as its rendered href. For example:
* <pre>
- * <netui-data:anchorCell href="foo.jsp" value="Go To Foo"/>
+ * <netui-data:anchorCell href="foo.jsp" value="Go To Foo"/>
* </pre>
* will render:
* <pre>
- * <a href="foo.jsp">Go To Foo</a>
+ * <a href="foo.jsp">Go To Foo</a>
* </pre>
* </p>
* <p>
@@ -61,7 +61,7 @@
* </pre>
* will render:
* <pre>
- * <a href="foo.jsp?paramKey=paramValue">Go To Foo</a>
+ * <a href="foo.jsp?paramKey=paramValue">Go To Foo</a>
* </pre>
* </p>
* <p>
@@ -82,24 +82,24 @@
* the action must exist inside of the 'current' Page Flow with which the JSP is associated. If the href is provided,
* the anchor will use this value as its rendered href. For example:
* <pre>
- * <netui-data:anchorCell href="foo.jsp" value="Go To Foo"/>
+ * <netui-data:anchorCell href="foo.jsp" value="Go To Foo"/>
* </pre>
* will render:
* <pre>
- * <a href="foo.jsp">Go To Foo</a>
+ * <a href="foo.jsp">Go To Foo</a>
* </pre>
* </p>
* <p>
* The AnchorCell tag can also accept NetUI parameter tags that implement the {@link IUrlParams} interface. When
* these tags are contained inside of this tag, they add URL parameters onto the rendered href. For example:
* <pre>
- * <netui-data:anchorCell href="foo.jsp" value="Go To Foo">
- * <netui:parameter name="paramKey" value="paramValue"/>
- * </netui-data:anchorCell>
+ * <netui-data:anchorCell href="foo.jsp" value="Go To Foo">
+ * <netui:parameter name="paramKey" value="paramValue"/>
+ * </netui-data:anchorCell>
* </pre>
* will render:
* <pre>
- * <a href="foo.jsp?paramKey=paramValue">Go To Foo</a>
+ * <a href="foo.jsp?paramKey=paramValue">Go To Foo</a>
* </pre>
* </p>
* <p>
@@ -151,7 +151,6 @@
*
* @param onDblClick the onDblClick event.
* @jsptagref.attributedescription The onDblClick JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onDblClick JavaScript event."
*/
@@ -164,7 +163,6 @@
*
* @param onKeyDown the onKeyDown event.
* @jsptagref.attributedescription The onKeyDown JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown JavaScript event."
*/
@@ -177,7 +175,6 @@
*
* @param onKeyUp the onKeyUp event.
* @jsptagref.attributedescription The onKeyUp JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp JavaScript event."
*/
@@ -190,7 +187,6 @@
*
* @param onKeyPress the onKeyPress event.
* @jsptagref.attributedescription The onKeyPress JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress JavaScript event."
*/
@@ -203,7 +199,6 @@
*
* @param onMouseDown the onMouseDown event.
* @jsptagref.attributedescription The onMouseDown JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown JavaScript event."
*/
@@ -216,7 +211,6 @@
*
* @param onMouseUp the onMouseUp event.
* @jsptagref.attributedescription The onMouseUp JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp JavaScript event."
*/
@@ -229,7 +223,6 @@
*
* @param onMouseMove the onMouseMove event.
* @jsptagref.attributedescription The onMouseMove JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove JavaScript event."
*/
@@ -242,7 +235,6 @@
*
* @param onMouseOut the onMouseOut event.
* @jsptagref.attributedescription The onMouseOut JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event."
*/
@@ -255,7 +247,6 @@
*
* @param onMouseOver the onMouseOver event.
* @jsptagref.attributedescription The onMouseOver JavaScript event for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver JavaScript event."
*/
@@ -433,7 +424,6 @@
* Sets the lang attribute for the HTML anchor.
* @param lang
* @jsptagref.attributedescription The lang attribute for the HTML anchor.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_lang</i>
* @netui:attribute required="false" rtexprvalue="true" description="The lang for the HTML anchor."
*/
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/DataGrid.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/DataGrid.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/DataGrid.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/DataGrid.java Thu May 19 12:28:44 2005
@@ -365,7 +365,6 @@
*
* @param onMouseOut the onMouseOut event.
* @jsptagref.attributedescription The onMouseOut JavaScript event for the HTML tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event for the HTML tag."
*/
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/GetDataGridState.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/GetDataGridState.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/GetDataGridState.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/GetDataGridState.java Thu May 19 12:28:44 2005
@@ -32,10 +32,10 @@
* UI for sorting, filtering, and paging, it is often necessary to gain access to the state exposed to a data
* grid via the {@link DataGridState} object. For example:
* <pre>
- * <netui-data:getDataGridState gridName="employees" var="employeeGridState"/>
- * <c:if test="${pageScope.employeeGridState.sortModel.sorts} != null}">
+ * <netui-data:getDataGridState gridName="employees" var="employeeGridState"/>
+ * <c:if test="${pageScope.employeeGridState.sortModel.sorts} != null}">
* ... render UI when sorts are present ...
- * </c:if>
+ * </c:if>
* </pre>
* this will expose the "employees" data grid's list of
* {@link org.apache.beehive.netui.databinding.datagrid.api.sort.SortModel#getSorts()} to the JSP for access by
@@ -49,10 +49,10 @@
* UI for sorting, filtering, and paging, it is often necessary to gain access to the state exposed to a data
* grid via the {@link DataGridState} object. For example:
* <pre>
- * <netui-data:getDataGridState gridName="employees" var="employeeGridState"/>
- * <c:if test="${pageScope.employeeGridState.sortModel.sorts} != null}">
+ * <netui-data:getDataGridState gridName="employees" var="employeeGridState"/>
+ * <c:if test="${pageScope.employeeGridState.sortModel.sorts} != null}">
* ... render UI when sorts are present ...
- * </c:if>
+ * </c:if>
* </pre>
* this will expose the "employees" data grid's list of
* {@link org.apache.beehive.netui.databinding.datagrid.api.sort.SortModel#getSorts()} to the JSP for access by
@@ -60,7 +60,7 @@
* </p>
*
* @netui:tag name="getDataGridState" body-content="scriptless"
- * description="Get a DataGridState object and add it to the PageContext under a given variable name"
+ * description="Get a DataGridState object and add it to the PageContext under a given variable name"
*/
public class GetDataGridState
extends AbstractSimpleTag {
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Header.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Header.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Header.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Header.java Thu May 19 12:28:44 2005
@@ -281,7 +281,6 @@
*
* @param align the alignment
* @jsptagref.attributedescription The horizontal alignment rendered by the HTML thead tag.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>string_align</i>
* @netui:attribute required="false" rtexprvalue="true" description="The horizontal alignment attribute rendered by the HTML thead tag."
*/
@@ -332,7 +331,6 @@
*
* @param lang the language
* @jsptagref.attributedescription The language attribute rendered by the HTML thead tag.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>string_lang</i>
* @netui:attribute required="false" rtexprvalue="true" description="The language attribute rendered by the HTML thead tag."
*/
@@ -345,7 +343,6 @@
*
* @param dir the dir attribute
* @jsptagref.attributedescription The text direction attribute rendered by the HTML thead tag.
- * @jsptagref.databindable true
* @jsptagref.attributesyntaxvalue <i>string_dir</i>
* @netui:attribute required="false" rtexprvalue="true" description="The text direction rendered by the HTML thead tag."
*/
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageAnchorCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageAnchorCell.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageAnchorCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageAnchorCell.java Thu May 19 12:28:44 2005
@@ -39,7 +39,7 @@
* inside of a <netui-data:rows> tag when rendering a data set with the <netui-data:dataGrid> tag.
* The rendered output is structured as:
* <pre>
- * <a ...><img .../></a>
+ * <a ...><img .../></a>
* </pre>
* If the {@link #setHref(String)} attribute is set, the href will be rendered on the anchor. If the {@link #setAction(String)}
* attribute is set, it must reference an action that is valid in the context of the current Page Flow. Only
@@ -57,6 +57,27 @@
* </p>
*
* @jsptagref.tagdescription
+ * <p>
+ * This tag is a data grid cell used to render an HTML image inside of an anchor. This tag should be used
+ * inside of a <netui-data:rows> tag when rendering a data set with the <netui-data:dataGrid> tag.
+ * The rendered output is structured as:
+ * <pre>
+ * <a ...><img .../></a>
+ * </pre>
+ * If the {@link #setHref(String)} attribute is set, the href will be rendered on the anchor. If the {@link #setAction(String)}
+ * attribute is set, it must reference an action that is valid in the context of the current Page Flow. Only
+ * one of these two attributes may be set. The image source to render on the image tag is specified using the
+ * {@link #setSrc(String)} attribute.
+ * </p>
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
+ * that exposes the current data item and the current item's index</li>
+ * </ul>
+ * </p>
*
* @netui:tag name="imageAnchorCell" body-content="scriptless"
* description="Renders an HTML table cell in a data grid that contains an HTML image inside of an anchor."
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java Thu May 19 12:28:44 2005
@@ -33,6 +33,7 @@
import org.apache.beehive.netui.tags.IHtmlI18n;
/**
+ * <p>
* Data grid cell that renders an HTML <image> tag containing the tag's <code>source</code> attribute. The
* span cell is rendered inside of an HTML table <td>. The image cell supports various nested tags including
* those that augment the available attribute set via the NetUI {@link org.apache.beehive.netui.tags.IAttributeConsumer}
@@ -47,10 +48,25 @@
* that exposes the current data item and the current item's index</li>
* </ul>
* </p>
-*
+ *
* @jsptagref.tagdescription
+ * <p>
+ * Data grid cell that renders an HTML <image> tag containing the tag's <code>source</code> attribute. The
+ * span cell is rendered inside of an HTML table <td>. The image cell supports various nested tags including
+ * those that augment the available attribute set via the NetUI {@link org.apache.beehive.netui.tags.IAttributeConsumer}
+ * interface.
+ * </p>
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
+ * that exposes the current data item and the current item's index</li>
+ * </ul>
+ * </p>
* @netui:tag name="imageCell" body-content="scriptless"
- * description=""
+ * description="Data grid cell tag that renders an HTML img inside of an HTML table cell."
*/
public class ImageCell
extends AbstractHtmlTableCell
@@ -75,7 +91,6 @@
*
* @param onClick the onClick event.
* @jsptagref.attributedescription The onClick JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onClick</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onClick JavaScript event on the image tag."
*/
@@ -88,7 +103,6 @@
*
* @param onDblClick the onDblClick event.
* @jsptagref.attributedescription The onDblClick JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onDblClick JavaScript event on the image tag."
*/
@@ -101,7 +115,6 @@
*
* @param onKeyDown the onKeyDown event.
* @jsptagref.attributedescription The onKeyDown JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown JavaScript event on the image tag."
*/
@@ -114,7 +127,6 @@
*
* @param onKeyUp the onKeyUp event.
* @jsptagref.attributedescription The onKeyUp JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp JavaScript event on the image tag."
*/
@@ -127,7 +139,6 @@
*
* @param onKeyPress the onKeyPress event.
* @jsptagref.attributedescription The onKeyPress JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress JavaScript event on the image tag."
*/
@@ -140,7 +151,6 @@
*
* @param onMouseDown the onMouseDown event.
* @jsptagref.attributedescription The onMouseDown JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown JavaScript event on the image tag."
*/
@@ -153,7 +163,6 @@
*
* @param onMouseUp the onMouseUp event.
* @jsptagref.attributedescription The onMouseUp JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp JavaScript event on the image tag."
*/
@@ -166,7 +175,6 @@
*
* @param onMouseMove the onMouseMove event.
* @jsptagref.attributedescription The onMouseMove JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove JavaScript event on the image tag."
*/
@@ -179,7 +187,6 @@
*
* @param onMouseOut the onMouseOut event.
* @jsptagref.attributedescription The onMouseOut JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event on the image tag."
*/
@@ -192,7 +199,6 @@
*
* @param onMouseOver the onMouseOver event.
* @jsptagref.attributedescription The onMouseOver JavaScript event on the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
* @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver JavaScript event on the image tag."
*/
@@ -205,7 +211,6 @@
*
* @param style the html style.
* @jsptagref.attributedescription The style.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_style</i>
* @netui:attribute required="false" rtexprvalue="true" description="The style."
*/
@@ -220,7 +225,6 @@
*
* @param styleClass the html style class.
* @jsptagref.attributedescription The style class.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_style_class</i>
* @netui:attribute required="false" rtexprvalue="true" description="The style class."
*/
@@ -235,7 +239,6 @@
*
* @param title
* @jsptagref.attributedescription The title.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_title</i>
* @netui:attribute required="false" rtexprvalue="true" description="The title. "
*/
@@ -247,7 +250,6 @@
* Sets the lang attribute for the HTML element.
* @param lang
* @jsptagref.attributedescription The lang.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_lang</i>
* @netui:attribute required="false" rtexprvalue="true"
* description="The lang."
@@ -261,7 +263,6 @@
* Sets the dir attribute for the HTML image tag.
* @param dir
* @jsptagref.attributedescription The dir for the image tag.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_dir</i>
* @netui:attribute required="false" rtexprvalue="true" description="The dir attribhte on the image tag."
*/
@@ -274,7 +275,6 @@
* Set the image source to render on the HTML image tag.
*
* @jsptagref.attributedescription The source of the image to display.
- * @jsptagref.databindable Read Only
* @jsptagref.attributesyntaxvalue <i>literal_or_expression_src</i>
* @netui:attribute required="true" rtexprvalue="true" description="The image source to render on the HTML image tag"
*/
@@ -287,7 +287,6 @@
*
* @param align the image alignment.
* @jsptagref.attributedescription The alignment of the image.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_align</i>
* @netui:attribute required="false" rtexprvalue="true" description="The alignment of the image."
*/
@@ -300,7 +299,6 @@
*
* @param hspace the horizontal spacing.
* @jsptagref.attributedescription The horizontal spacing around the image.
- * @jsptagref.databindable Read Only
* @jsptagref.attributesyntaxvalue <i>integer_hspace</i>
* @netui:attribute required="false" rtexprvalue="true" description="The horizontal spacing around the image."
*/
@@ -312,7 +310,6 @@
* Set the vertical spacing around the image.
*
* @jsptagref.attributedescription The width of the border around the image.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>integer_border</i>
* @netui:attribute required="false" rtexprvalue="true" description="The vertical spacing around the image"
*/
@@ -324,7 +321,6 @@
* Set the border attribute for the image.
*
* @jsptagref.attributedescription The border attribute of the image.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>height</i>
* @netui:attribute required="false" rtexprvalue="true" description="The border attribute for the image"
*/
@@ -336,7 +332,6 @@
* Set the height of the image to display.
*
* @jsptagref.attributedescription The height of the image to be displayed.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>integer_height</i>
* @netui:attribute required="false" rtexprvalue="true" description="The height attribute for the image."
*/
@@ -348,7 +343,6 @@
* Set the width of the image to display.
*
* @jsptagref.attributedescription The width of the image to be displayed.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>width</i>
* @netui:attribute required="false" rtexprvalue="true" description="The width attribute for the image"
*/
@@ -361,7 +355,6 @@
*
* @param longdesc the longdesc attribute
* @jsptagref.attributedescription The alternative text of the image tag
- * @jsptagref.databindable Read Only
* @jsptagref.attributesyntaxvalue <i>string_longdesc</i>
* @netui:attribute required="false" rtexprvalue="true" description="The longdesc of the image tag."
*/
@@ -374,7 +367,6 @@
*
* @param alt the image alignment.
* @jsptagref.attributedescription The alternative text of the image tag
- * @jsptagref.databindable Read Only
* @jsptagref.attributesyntaxvalue <i>string_alt</i>
* @netui:attribute required="false" rtexprvalue="true" description="The alternative text for the image tag."
*/
@@ -387,7 +379,6 @@
*
* @param tagId the the name of the tagId for the image tag.
* @jsptagref.attributedescription The tagId.
- * @jsptagref.databindable false
* @jsptagref.attributesyntaxvalue <i>string_tagId</i>
* @netui:attribute required="false" rtexprvalue="true"
* description="String value. Sets the id (or name) attribute of the rendered HTML image tag."
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java Thu May 19 12:28:44 2005
@@ -29,16 +29,16 @@
* this tag can be used to move the rendered pager or to render multiple pagers. For example, to render
* a pager in both the grid's header and footer, the tag can be used as:
* <pre>
- * <netui-data:header>
+ * <netui-data:header>
* ....
- * <netui-data;renderPager/>
+ * <netui-data;renderPager/>
* ....
- * </netui-data:header>
- * <netui-data:footer>
+ * </netui-data:header>
+ * <netui-data:footer>
* ....
- * <netui-data;renderPager/>
+ * <netui-data;renderPager/>
* ....
- * </netui-data:footer>
+ * </netui-data:footer>
* </pre>
* </p>
*
@@ -49,21 +49,21 @@
* this tag can be used to move the rendered pager or to render multiple pagers. For example, to render
* a pager in both the grid's header and footer, the tag can be used as:
* <pre>
- * <netui-data:header>
+ * <netui-data:header>
* ....
- * <netui-data;renderPager/>
+ * <netui-data;renderPager/>
* ....
- * </netui-data:header>
- * <netui-data:footer>
+ * </netui-data:header>
+ * <netui-data:footer>
* ....
- * <netui-data;renderPager/>
+ * <netui-data;renderPager/>
* ....
- * </netui-data:footer>
+ * </netui-data:footer>
* </pre>
* </p>
*
* @netui:tag name="renderPager" body-content="empty"
- * description="Data grid tag used to render the grid's pager at a specific location in a JSP."
+ * description="Data grid tag used to render the grid's pager at a specific location in a JSP."
*/
public class RenderPager
extends AbstractDataGridHtmlTag {
Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java?rev=170981&r1=170980&r2=170981&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java Thu May 19 12:28:44 2005
@@ -46,17 +46,17 @@
* allow a page author to set JSP tag attributes that can configure each rendered table row differently.
* For example:
* <pre>
- * <netui-data:rows renderRows="false">
- * <netui-data:row styleClass="rowStyle${container.index}">
- * <netui-data:spanCell value="${container.item}"/>
- * </netui-data:row>
- * </netui-data:rows>
+ * <netui-data:rows renderRows="false">
+ * <netui-data:row styleClass="rowStyle${container.index}">
+ * <netui-data:spanCell value="${container.item}"/>
+ * </netui-data:row>
+ * </netui-data:rows>
* </pre>
* and a data set containing ["foo", "bar", "baz"] will render:
* <pre>
- * <tr class="rowStyle0">foo</tr>
- * <tr class="rowStyle1">bar</tr>
- * <tr class="rowStyle2">baz</tr>
+ * <tr class="rowStyle0">foo</tr>
+ * <tr class="rowStyle1">bar</tr>
+ * <tr class="rowStyle2">baz</tr>
* </pre>
* If the <netui-data:row$gt; were omitted, none of the <tr> elements would be rendered in the output. Note,
* this tag <b>should not</b> be used inside of the Header, Rows, or Footer tags unless their <code>renderRow</code>
@@ -72,17 +72,17 @@
* allow a page author to set JSP tag attributes that can configure each rendered table row differently.
* For example:
* <pre>
- * <netui-data:rows renderRows="false">
- * <netui-data:row styleClass="rowStyle${container.index}">
- * <netui-data:spanCell value="${container.item}"/>
- * </netui-data:row>
- * </netui-data:rows>
+ * <netui-data:rows renderRows="false">
+ * <netui-data:row styleClass="rowStyle${container.index}">
+ * <netui-data:spanCell value="${container.item}"/>
+ * </netui-data:row>
+ * </netui-data:rows>
* </pre>
* and a data set containing ["foo", "bar", "baz"] will render:
* <pre>
- * <tr class="rowStyle0">foo</tr>
- * <tr class="rowStyle1">bar</tr>
- * <tr class="rowStyle2">baz</tr>
+ * <tr class="rowStyle0">foo</tr>
+ * <tr class="rowStyle1">bar</tr>
+ * <tr class="rowStyle2">baz</tr>
* </pre>
* If the <netui-data:row$gt; were omitted, none of the <tr> elements would be rendered in the output. Note,
* this tag <b>should not</b> be used inside of the Header, Rows, or Footer tags unless their <code>renderRow</code>