The child components of each Column display the data for each row in
that column. The Column does not create child components per row;
instead, each child is repeatedly rendered (stamped) once per
row. Because of this stamping behavior, only certain types of
components are supported as children inside a Column. Supported
components include all components with no behavior and most
components that implement the EditableValueHolder or ActionSource
interfaces.

As each row is stamped, the data for the current row ( see
getRowData() on the Table)
is copied into an EL reachable property.
The name of this property is defined by the var
property on the Table. Once the Table has completed rendering, this
property is removed (or reverted back to its previous value). In
the following example, the data for each row is placed under the EL
property "row". Each Column displays the data for each row by getting
further properties from the "row" property:

The Column component supports the following attributes related to
formatting:

align

The type of alignment to use for this column. This
atribute controls left/start, right/end, or center justification of the
column data.

width

The width of this column.

noWrap

Controls whether long lines of text in the column data should
be wrapped.

headerNoWrap

Controls whether long lines of text in the column header should
be wrapped.

separateRows

Controls whether each child of this
column should be rendered in separate cells, or inside the same
cell.

In order to make this Column sortable, set the "sortable"
property to true and set "sortProperty" to the name of the
model that this column will sort. Sorting can be programatically
turned on with the setSortCritiera() method on the\
table.

<tr:column> tags can be nested to produce
groups of columns. The header of a column group spans across
all the columns it contains. The following example creates
a column group that has the header "Name" and contains
two sub columns with headers "First" and "Last":

Events:

Type

Phases

Description

org.apache.myfaces.trinidad.event.AttributeChangeEvent

InvokeApplicationApplyRequestValues

Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing.

Identifiers must account for NamingContainers. You can use a single colon to start the search from the root,
or use multiple colons to move up through the NamingContainer. For example,
"::" will pop out of this component's naming container (it pops out of itself if it is a naming container),
":::" will pop out of two naming containers, etc. The search for
the partialTrigger begins from there. e.g., partialTriggers=":::commandButton1" the search begins for the
component with id = commandButton1 after popping out of two naming containers relative to this component.
To go into naming containers, you separate the naming containers with ':', e.g.,partialTriggers= "nc1:nc2:nc3:componentId".

Identifiers must account for NamingContainers. You can use a single colon to start the search from the root,
or use multiple colons to move up through the NamingContainer. For example,
"::" will pop out of this component's naming container (it pops out of itself if it is a naming container),
":::" will pop out of two naming containers, etc. The search for
the partialTrigger begins from there. e.g., partialTriggers=":::commandButton1" the search begins for the
component with id = commandButton1 after popping out of two naming containers relative to this component.
To go into naming containers, you separate the naming containers with ':', e.g.,partialTriggers= "nc1:nc2:nc3:componentId".

setOnkeyup

getAlign

Gets The alignment for this column. The legal values are "start", "end" and "center", for left-justified, right-justified, and center-justified respectively in LTR display. The default value is "start".

Returns:

the new align value

setAlign

Sets The alignment for this column. The legal values are "start", "end" and "center", for left-justified, right-justified, and center-justified respectively in LTR display. The default value is "start".

setHeaderText

Sets text to display in the header of the column. This is a convenience that generates output equivalent to adding a "header" facet containing an outputText.

Parameters:

headerText - the new headerText value

isNoWrap

public final boolean isNoWrap()

Gets whether or not the column contents should be allowed to wrap

Returns:

the new noWrap value

setNoWrap

public final void setNoWrap(boolean noWrap)

Sets whether or not the column contents should be allowed to wrap

Parameters:

noWrap - the new noWrap value

isHeaderNoWrap

public final boolean isHeaderNoWrap()

Gets whether or not the column header
should be allowed to wrap

Returns:

the new headerNoWrap value

setHeaderNoWrap

public final void setHeaderNoWrap(boolean headerNoWrap)

Sets whether or not the column header
should be allowed to wrap

Parameters:

headerNoWrap - the new headerNoWrap value

isSortable

public final boolean isSortable()

Gets whether or not the column is sortable. A sortable column has a clickable header that (when clicked) sorts the table by that column's property. Note that in order for a column to be sortable, this attribute must be set to "true" and the underlying model must support sorting by this column's property.

This column's "sortProperty" attribute must be set if sorting is desired.

Returns:

the new sortable value

setSortable

public final void setSortable(boolean sortable)

Sets whether or not the column is sortable. A sortable column has a clickable header that (when clicked) sorts the table by that column's property. Note that in order for a column to be sortable, this attribute must be set to "true" and the underlying model must support sorting by this column's property.

This column's "sortProperty" attribute must be set if sorting is desired.

Parameters:

sortable - the new sortable value

isSeparateRows

public final boolean isSeparateRows()

Gets whether or not the children of this column should be rendered on separate rows. Setting this attribute to true will cause each child to render in its own row. Setting this to false will cause all the children to be rendered in one cell, which will rowSpan across the rows of the Columns whose children are rendered on separate rows.

Returns:

the new separateRows value

setSeparateRows

public final void setSeparateRows(boolean separateRows)

Sets whether or not the children of this column should be rendered on separate rows. Setting this attribute to true will cause each child to render in its own row. Setting this to false will cause all the children to be rendered in one cell, which will rowSpan across the rows of the Columns whose children are rendered on separate rows.