myfaces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mcoo...@apache.org
Subject 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
Date Fri, 11 Feb 2011 17:11:30 GMT
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>



Mime
View raw message