Tobago Components 1.5.x
Tag gridLayout


Renders a GridLayout.
 columns/rows ::= LAYOUT LAYOUT ::= TOKEN [";" TOKEN]+ TOKEN ::= AUTO | PIXEL | PROPORTIONAL AUTO ::= "auto" | "fixed" PIXEL ::= NUMBER "px" PROPORTIONAL ::= [NUMBER] "*" 

Parent Child Okay? Remarks
AUTO any combination of AUTO or PIXEL but no PROPORTIONAL okay -
AUTO any combination with at least one PROPORTIONAL wrong LayoutManager cannot compute the auto value.
PIXEL any combination of AUTO or PIXEL but no PROPORTIONAL potentially wrong The values depend on each other, the programmer has to keep consistency manually.
PIXEL any combination with at least one PROPORTIONAL okay -
PROPORTIONAL any combination of AUTO or PIXEL but no PROPORTIONAL potentially wrong No automatic matching:
  • too little space: scroll bar
  • too much space: elements will be spread.
PROPORTIONAL any combination with at least one PROPORTIONAL okay -

UIComponentClass: org.apache.myfaces.tobago.component.UIGridLayout

RendererType: GridLayout



Tag Information
Tag Classorg.apache.myfaces.tobago.internal.taglib.GridLayoutTag
TagExtraInfo ClassNone
Body Contentempty
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
idfalsetruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
Type: java.lang.String
borderfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Border size of this component.
Type: java.lang.String
cellspacingfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)

**** @deprecated. Will be removed in a future version ****

Use columnSpacing and/or rowSpacing instead.

Spacing between component and layout cell's. Can be overwritten by columnSpacing and rowSpacing.
Type: org.apache.myfaces.tobago.layout.Measure
columnSpacingfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Spacing between the columns in the actual layout.
Type: org.apache.myfaces.tobago.layout.Measure
rowSpacingfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Spacing between the rows in the actual layout.
Type: org.apache.myfaces.tobago.layout.Measure
marginfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginBottomfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Bottom margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginLeftfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Left margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginRightfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Right margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginTopfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Top margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
columnsfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This value defines the layout constraints for column layout. It is a semicolon separated list of layout tokens '[<n>]*', '<n>px' or 'auto'. Where <n> is a non negative integer and the square brackets means optional. Example: '2*;*;100px;auto'.
Type: java.lang.String
Default: 1*
rowsfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This value defines the layout constraints for column layout. It is a semicolon separated list of layout tokens '[<n>]*', '<n>px' or 'auto'. Where <n> is a non negative integer and the square brackets means optional. Example: '2*;*;100px;auto'.
Type: java.lang.String
Default: 1*
bindingfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
The value binding expression linking this component to a property in a backing bean.

Warning: For the tobago extension library tx the binding differs from JSP and Facelets:

  • JSP: The component is the inner main control (e. g. UIInput).
  • Facelets: The component is the outer UIPanel.

Type: javax.faces.component.UIComponent
markupfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.context.Markup)
Indicate markup of this component. The allowed markups can be defined or overridden in the theme. The value 'none' should not be used any longer. Just leave the attribute empty, or use a NULL pointer.
Type: org.apache.myfaces.tobago.context.Markup
columnOverflowfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
This attribute is a hint for the layout manager. Should not be used in most cases.
Type: boolean
rowOverflowfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
This attribute is a hint for the layout manager. Should not be used in most cases.
Type: boolean

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.