svn commit: r1069895 - /myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml

[mc...@apache.org]

Author: mcooper
Date: Fri Feb 11 17:11:29 2011
New Revision: 1069895

URL: http://svn.apache.org/viewvc?rev=1069895&view=rev
Log:
TRINIDAD-2033 trh:tableLayout tag doc should call out table-layout:fixed as desirable for programmatically-resizable cell contents

Tag documentation-only update.

Added a section in the tag documentation for trh:tableLayout explaining how column sizes are resolved by default and how you can alter the layout algorithm to better meet uses cases like when your cell contents have percentage widths and their content is programmatically-sized (e.g. via JavaScript resize handlers).

Modified:
    myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml

Modified: myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml
URL: http://svn.apache.org/viewvc/myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml?rev=1069895&r1=1069894&r2=1069895&view=diff
==============================================================================
--- myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml (original)
+++ myfaces/trinidad/branches/trinidad-1.2.x/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/html/HtmlTableLayout.xml Fri Feb 11 17:11:29 2011
@@ -243,7 +243,16 @@
       <mfp:tag-name>trh:tableLayout</mfp:tag-name>
       <mfp:tag-class>org.apache.myfaces.trinidadinternal.taglib.html.HtmlTableLayoutTag</mfp:tag-class>
       <mfp:long-description><![CDATA[A TableLayout is a thin wrapper around the HTML &lt;table&gt;
-          element.  It contains a series of row layout elements.]]>
+          element.  It contains a series of row layout elements.
+         <section name="Table Layout">
+          By default, HTML tables treat cell widths more like suggestions rather than requirements;
+          cell content sizes contribute more in determining the size of each column.
+          If you care more for the specified cellFormat widths than content sizes (particularly if your
+          cellFormat widths are percentage-based and your cells have contents that are
+          programmatically-resizable based on the cell width), then you will need to use
+          inlineStyle="table-layout:fixed" to declare that you want your cell widths to be explicitly honored.
+          Refer to the CSS specification for further details on this style property.
+          </section>]]>
       </mfp:long-description>
       <mfp:example>
         <mfp:source-code>