Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces-EE ACE Components
Tag column

Component that represents a column in an ace:dataTable.

For more information, see the Column Wiki Documentation.

Facets
filter | An optional facet that is rendered in place of the built-in filtering inputs to provide more flexibility when filtering values. This facet is rendered as a simple popup dialog. When using this facet, the 'filterValue' property has to be set as well.

Tag Information
Tag Class | org.icefaces.ace.component.column.ColumnTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
binding | no | true | `javax.el.ValueExpression` | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
colspan | no | true | `int` | Defines the number of columns the rendered cell spans. Only significant to Column components within a column group. Default = '1'.
configurable | no | true | `boolean` | When disabled, this column is excluded from the list of columns available for configuration on a TableConfigPanel component. Default = 'true'.
filterBy | no | true | `java.lang.Object` | Defines a ValueExpression of the value of this row to use when filtering this column. Setting this attribute, or the "value" attribute for a column enables filtering.
filterMatchMode | no | true | `java.lang.String` | Defines the method of filter comparison used, default is "startsWith". Types available include: "contains", "exact", "startsWith" and "endsWith". Default = 'startsWith'.
filterOptions | no | true | `java.lang.Object` | Defines a collection of SelectItem objects for use as filter choices.
filterStyle | no | true | `java.lang.String` | Defines additional CSS rules to be applied to the filter text input.
filterStyleClass | no | true | `java.lang.String` | Defines supplementary CSS classes to add to those already applied on this component.
filterValue | no | true | `java.lang.String` | Defines the string input filtering this column, coming from the client, or from the application via a value binding.
filterValues | no | true | `java.lang.Object` | Defines multiple filter values. This property can only be set programmatically, typically when using the filter facet as well. The value must be a Collection or an Array of strings. If this attribute is set, 'filterValue' is ignored.
footerText | no | true | `java.lang.String` | Defines a plain text footer with less effort than adding a facet.
groupBy | no | true | `java.lang.Object` | Defines a value expression representing the value of this column per row when determining if the values of this column in sibling rows are equal. If they are equal, span the rows witha single column cell.
headerText | no | true | `java.lang.String` | Defines a plain text header with less effort than adding a facet. Note that even when using a header facet this property should also be set as a short-form label for the column that will be used within the ace:tableConfigPanel.
hideSortControls | no | true | `boolean` | When true, the sort controls in the column header will not be rendered. Default = 'false'.
id | no | 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.
lazyColumnKey | no | true | `java.lang.String` | Specifies a string that will be used to identify this column when working in lazy mode. This string will be passed as a key of the filters map and will be returned from SortCriteria.getPropertyName() in the LazyDataModel.load() method. If this attribute is defined, then this value will be used instead of the value obtained by parsing the EL expressions of the sortyBy and filterBy attributes. This attribute is useful when using complex and/or dynamic EL expressions that can't be parsed nor resolved at render time, such as when using c:forEach to define the columns.
pinningOrder | no | true | `java.lang.Integer` | Define the position of this column in the pinned column region when column pinning and scrolling are enabled at the table level. Having a value in this field indicates a column is pinned. 1 indexed.
rendered | no | true | `boolean` | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
reorderable | no | true | `boolean` | Enables per-column control of column ordering when the attribute ("reorderableColumns") is true at the table level. Default = 'true'.
rowspan | no | true | `int` | Defines the number of rows the rendered cell spans. Only significant to Column components within a column group. Default = '1'.
selectBy | no | true | `java.lang.Object` | Defines a value expression representing the value of this column per row when using cell selection. Defining this attribute, or the "value" attribute, enables cell selection for this column when also enabled at the table level.
sortAscending | no | true | `java.lang.Boolean` | Defines the direction of column values during sorting. The column directions incoming from the client during a sort request overwrite any set by the application. Processing the sorted columns is done by the component whenever a client edits a sort control or the application calls table.applySorting(). Default = 'false'.
sortBy | no | true | `java.lang.Object` | Defines a value expression representing the value of this column per row when sorting. Setting this attribute, or the "value" attribute for a column enables sorting.
sortFunction | no | true | `java.util.Comparator` | Defines an alternate method of sorting. Sort this column using a Comparator
sortPriority | no | true | `java.lang.Integer` | Defines the priority of a column during sorting. The column priorities incoming from the client during a sort request overwrite any set by the application. Processing the sorted columns is done by the component whenever a client edits a sort control or the application calls table.applySorting().
sortWhenGrouping | no | true | `boolean` | When disabled, this column will neither be sortable nor automatically sorted when using the groupBy attribute. Default = 'true'.
stacked | no | true | `boolean` | When enabled, this column is rendered underneath the previous column.
style | no | true | `java.lang.String` | Custom inline CSS styles to use for this component. These styles are generally applied to the root DOM element of the component. This is intended for per-component basic style customizations. Note that due to browser CSS precedence rules, CSS rendered on a DOM element will take precedence over the external stylesheets used to provide the ThemeRoller theme on this component. If the CSS properties applied with this attribute do not affect the DOM element you want to style, you may need to create a custom theme styleClass for the theme CSS class that targets the particular DOM elements you wish to customize.
styleClass | no | true | `java.lang.String` | Custom CSS style class(es) to use for this component. These style classes can be defined in your page or in a theme CSS file.

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.