tc
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 ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
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
borderfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Border size of this component.
Type: java.lang.String
cellspacingfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)

**** @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
columnOverflowfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
This attribute is a hint for the layout manager. Should not be used in most cases.
Type: boolean
columnSpacingfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Spacing between the columns in the actual layout.
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 '[]*', 'px' or 'auto'. Where is a non negative integer and the square brackets means optional. Example: '2*;*;100px;auto'.
Type: java.lang.String
Default: 1*
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
marginfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginBottomfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Bottom margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginLeftfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Left margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginRightfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Right margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
marginTopfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Top margin between container component and the children.
Type: org.apache.myfaces.tobago.layout.Measure
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
rigidfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
This attribute advises the layout manager, to not use space that comes from non rendered components.
Type: boolean
rowOverflowfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
This attribute is a hint for the layout manager. Should not be used in most cases.
Type: boolean
rowSpacingfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.layout.Measure)
Spacing between the rows in the actual layout.
Type: org.apache.myfaces.tobago.layout.Measure
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 '[]*', 'px' or 'auto'. Where is a non negative integer and the square brackets means optional. Example: '2*;*;100px;auto'.
Type: java.lang.String
Default: 1*

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.