gridLayout (Tobago Core Tag library documentation)

Overview

Library

Tag

Help

FRAMES NO FRAMES

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 -

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 Class	org.apache.myfaces.tobago.internal.taglib.GridLayoutTag
TagExtraInfo Class	None
Body Content	JSP
Display Name	None

Attributes
Name	Required	Request-time	Type	Description
binding	false	false	`javax.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`
border	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Border size of this component. Type: `java.lang.String`
cellspacing	false	false	`javax.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`
columnOverflow	false	false	`javax.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`
columnSpacing	false	false	`javax.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`
columns	false	false	`javax.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`
id	false	true	`java.lang.String`	The component identifier for this component. This value must be unique within the closest parent component that is a naming container. Type: `java.lang.String`
margin	false	false	`javax.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`
marginBottom	false	false	`javax.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`
marginLeft	false	false	`javax.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`
marginRight	false	false	`javax.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`
marginTop	false	false	`javax.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`
markup	false	false	`javax.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`
rigid	false	false	`javax.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`
rowOverflow	false	false	`javax.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`
rowSpacing	false	false	`javax.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`
rows	false	false	`javax.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.

Overview

Library

Tag

Help

FRAMES NO FRAMES

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.

tc Tag gridLayout

tc
Tag gridLayout