You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lo...@apache.org on 2007/07/30 16:04:22 UTC
svn commit: r560986 -
/myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java
Author: lofwyr
Date: Mon Jul 30 07:04:21 2007
New Revision: 560986
URL: http://svn.apache.org/viewvc?view=rev&rev=560986
Log:
layout manager docu
Modified:
myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java
Modified: myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java
URL: http://svn.apache.org/viewvc/myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java?view=diff&rev=560986&r1=560985&r2=560986
==============================================================================
--- myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java (original)
+++ myfaces/tobago/trunk/core/src/main/java/org/apache/myfaces/tobago/taglib/component/GridLayoutTagDeclaration.java Mon Jul 30 07:04:21 2007
@@ -36,6 +36,67 @@
* Time: 16:58:13
*/
+/**
+ *
+ * <code>
+ * columns/rows ::= LAYOUT
+ * LAYOUT ::= TOKEN [";" TOKEN]+
+ * TOKEN ::= FIXED | PIXEL | PROPORTIONAL
+ * FIXED ::= "fixed"
+ * PIXEL ::= NUMBER "px"
+ * PROPORTIONAL ::= [NUMBER] "*"
+ * </code>
+
+ <table border="1">
+ <tr>
+ <th>Parent</th>
+ <th>Child</th>
+ <th>Okay?</th>
+ <th>Remarks</th>
+ </tr>
+ <tr>
+ <td rowspan="2">FIXED</td>
+ <td>any combination of FIXED or PIXEL but no PROPORTIONAL</td>
+ <td>okay</td>
+ <td/>
+ </tr>
+ <tr>
+ <!--<td>FIXED</td>-->
+ <td>any combination with at least one PROPORTIONALÂ
+ <td>wrong</td>
+ <td>LayoutManager can't compute the fixed value.</td>
+ </tr>
+ <tr>
+ <td rowspan="2">PIXEL</td>
+ <td>any combination of FIXED or PIXEL but no PROPORTIONAL</td>
+ <td>potentially wrong</td>
+ <td>The values depends on each other, the programmer has to keep consitency manually.</td>
+ </tr>
+ <tr>
+ <!--<td>PIXEL</td>-->
+ <td>any combination with at least one PROPORTIONALÂ
+ <td>okay</td>
+ <td/>
+ </tr>
+ <tr>
+ <td rowspan="2">PROPORTIONAL</td>
+ <td>any combination of FIXED or PIXEL but no PROPORTIONAL</td>
+ <td>potentially wrong</td>
+ <td>No automatical matching:<br/> Â
+ a) to less space: scrollbar<br/> Â
+ b) to much space: elements will be speaded.</td>
+ </tr>
+ <tr>
+ <!--<td>PROPORTIONAL</td>-->
+ <td>any combination with at least one PROPORTIONALÂ
+ </td>
+ <td>okay</td>
+ <td/>
+ </tr>
+ </table>
+
+ */
+
@Tag(name = "gridLayout", bodyContent = BodyContent.EMPTY)
@UIComponentTag(
uiComponent = "org.apache.myfaces.tobago.component.UIGridLayout",