A control that determines the content of a data table's column. The content of the column renders multiple times, once for each row displayed by the table.
The Standard Column control is different from the Basic Column control in that it does not have a footer facet, and its header automatically incorporates the functionality of the Column Sort Link control.
The column control also optionally specifies the sorting behavior for the column. To enable sorting, configure both the table and each sortable column with an id
property. Each sortable column must have a sort
property.
The sort
property specifies a key to sort the column. The key is a ValueBinding expression bound to the current row object. For example, to sort on the name
property of the current row, use an expression "#{row.name}". The table's row variable, configured using the var
property was a row. To sort on the zeroth index of a row object, when the row object is an array or list, use an expression "#{row0}". You can use any property whose values support the java.lang.Comparable
interface for sorting. The data model feed to the table does the sorting, and some data models might use keys other than ValueBinding expressions.
The ascending
and ordinal
properties specify the default sorting state of the column. For example, you want to sort a table with a type column and a name column. By default you can sort the table first by type, with larger type numbers first, and then by name, alphabetically:
TYPE NAME
8000 Phase-a-tron
8000 The Destruction Maker
7000 Laser, Blue
7000 Laser, Green
7000 Laser, Red
0400 Advil
0400 Anvil
Set the ascending
property of the type column to false, and the ordinal
property of the type column to 1. Next set the ascending
property of the name column to true, and the ordinal
property of the name column to 2.
Children
Any.
Info | Value |
---|---|
Component Type | com.webmethods.caf.faces.table.html.HtmlTableColumn |
Handler Class | com.webmethods.caf.faces.component.table.html.HtmlTableColumnHandler |
Renderer Type | com.webmethods.caf.faces.render.table.IExtendedColumnRenderer |
Description | Standard table column with Sort Column Link built into header |
Palette Location | CAF Html/Control/Table/Standard Column |
Name | Description |
---|---|
header | Column header |
Name | Required | Type | Description |
---|---|---|---|
align | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
|
Horizontal alignment of column
Valid values are:
|
allowToggle | false | javax.el.ValueExpression
(must evaluate to boolean )
|
Allowing toggling between sorting ascending and sorting descending
If not specified, the default value is "true". |
ascending | false | javax.el.ValueExpression
(must evaluate to boolean )
|
True to sort from A-Z, 1-10, Jan-Dec, etc.
If not specified, the default value is "true". |
exportable | false | javax.el.ValueExpression
(must evaluate to boolean )
|
If true, include this column when the exporting the table data
If not specified, the default value is "true". |
footerClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| Space-separated list of CSS style class(es) that will be applied to any column footer generated for this table. |
group | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| Display title of column group (for Add/Remove Columns dialog); null or "" is the Default group |
headerClass | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| Space-separated list of CSS style class(es) that will be applied to any column header generated for this table. |
id | false | java.lang.String | Control identifier |
label | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| Display title of column (for Add/Remove Columns dialog) |
nowrap | false | javax.el.ValueExpression
(must evaluate to boolean )
|
True if column should be as wide as widest line in the column content
If not specified, the default value is "false". |
optional | false | javax.el.ValueExpression
(must evaluate to boolean )
|
True if column displayed only after chosen via Add/Remove Columns dialog
If not specified, the default value is "false". |
ordinal | false | javax.el.ValueExpression
(must evaluate to java.lang.Integer )
|
Primacy of this column in sorting the table; 0 = none, 1 = primary, 2 = secondary, etc
If not specified, the default value is "0". |
rendered | false | javax.el.ValueExpression
(must evaluate to boolean )
|
True to render control; false to ignore it
If not specified, the default value is "true". |
sort | false | javax.el.ValueExpression
(must evaluate to java.lang.Object )
| Sort key |
valign | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
|
Vertical alignment of column
Valid values are:
|
width | false | javax.el.ValueExpression
(must evaluate to java.lang.String )
| Width of table in pixels ('100') or percent ('100%') |
Output generated by Vdldoc View Declaration Language Documentation Generator.