q
Tag columns


The Columns component is used to specify dynamic number of columns in the dataTable or treeTable components. Child components of the tag are used to render each cell. All of the attributes of tag are analogous to their counterparts in the tag but they have one valuable difference - an ability for the attributes to be specified as value binding expressions that allow specifying column attributes on a per-column basis. When specify child components of the tag, the "var" request-scope variables from the and tags can be used (apart form "value" and "var" attributes). Component can be specified only as a child tag for the dataTable or treeTable.


Tag Information
Tag Classteamdev.jsf.taglib.TableColumnsJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
alignfalsejava.lang.StringtruenullThe alignment of the dynamic column content. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyClassfalsejava.lang.StringtruenullA CSS class name for the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOndblclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnmousedownfalsejava.lang.StringtruenullJavaScript code that should be executed when the user clicks the mouse button over the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnmousemovefalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer over the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnmouseoutfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer away from the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnmouseoverfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer onto the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyOnmouseupfalsejava.lang.StringtruenullJavaScript code that should be executed when the user releases the mouse button over the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
bodyStylefalsejava.lang.StringtruenullA style for the dynamic column's body. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
columnIdfalsejava.lang.StringonlynullA value-binding expression that should reference an identifier for each dynamic column. You can use a column data variable specified in the "var" in the expression for this attribute. Note that column IDs evaluated for columns inside the q:columns tag are used in the same way as "id" attributes of ordinary q:column tags, so the identifiers evaluated using this expression should be unique in bounds of the containing table.
columnRenderedfalsebooleantruetrueA flag that indicates whether or not each dynamic column is visible. Can be specified right on the page (one and the same value for all dynamic columns is used) or as a value-binding expression. You can use a column data variable specified in the "var" in the expression for this attribute.
filterCellClassfalsejava.lang.StringtruenullA CSS class name for the cell in the filter row (row that contains the filter components). Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
filterCellStylefalsejava.lang.StringtruenullA style for the cell in the filter row (row that contains the filter components). Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
filterExpressionfalsejava.lang.StringonlynullA value-binding expression that should reference the value by which the data in each dynamic column is filtered. You can use a column data variable specified in the "var" in the expression for this attribute. Specifying this attribute makes all columns in this q:columns tag to be filterable. Some dynamic columns can be made non-filterable using the filterKind attribute if needed.
filterKindfalseFilterKindtrue"comboBox"The type of filter component for filtering the data. Can be specified right on the page (one and the same value for all dynamic columns is used) or as a value-binding expression. You can use a column data variable specified in the "var" in the expression for this attribute. Returning null makes the corresponding dynamic columns non-filterable.
Available values are:
"searchField" — is displayed as a text field
"comboBox" — is displayed as a combo box that contains all the unique values returned by the filterExpression attribute for that column
"dropDownField" — is displayed as a drop-down field which, like "comboBox", displays all the unique values and also allows the user to enter text manually
filterValuefalseTextFilterCriterion,
EmptyRecordsCriterion,
NonEmptyRecordsCriterion
onlynullA value-binding expression that should reference the current filter value for each dynamic column. You can use a column data variable specified in the "var" in the expression for this attribute.
filterValuesfalsejava.util.CollectiononlynullA value-binding expression that should reference a collection of the filter values that appear in the "comboBox" or "dropDownField" filter components instead of displaying all of the possible values. You can use a column data variable specified in the "var" in the expression for this attribute. If returns null, the default filter values calculation mechanism is used for the corresponding dynamic columns.
footerClassfalsejava.lang.StringtruenullA CSS class name for the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOndblclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnmousedownfalsejava.lang.StringtruenullJavaScript code that should be executed when the user clicks the mouse button over the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnmousemovefalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer over the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnmouseoutfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer away from the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnmouseoverfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer onto the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerOnmouseupfalsejava.lang.StringtruenullA value-binding expression that should reference JavaScript code that should be executed when the user releases the mouse button over the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
footerStylefalsejava.lang.StringtruenullA style for the dynamic column's footer. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerClassfalsejava.lang.StringtruenullA CSS class name for Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOndblclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnmousedownfalsejava.lang.StringtruenullJavaScript code that should be executed when the user clicks over the dynamic column's header with either mouse button. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnmousemovefalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer over the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnmouseoutfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer away from the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnmouseoverfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer onto the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerOnmouseupfalsejava.lang.StringtruenullJavaScript code that should be executed when the user releases the mouse button over the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
headerStylefalsejava.lang.StringtruenullA style for the dynamic column's header. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
minResizingWidthfalsejava.lang.StringtruenullApplicable only when column resizing is enabled for a table. Specifies the minimum width that this column can take when the user resizes this column. It can be specified using any CSS units except percent. This attribute can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
ondblclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onmousedownfalsejava.lang.StringtruenullJavaScript code that should be executed when the user clicks over the dynamic column with either mouse button. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onmousemovefalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer over the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onmouseoutfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer away from the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onmouseoverfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer onto the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
onmouseupfalsejava.lang.StringtruenullJavaScript code that should be executed when the user releases the mouse button over the dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
resizeablefalsebooleantruenoneApplicable only when column resizing is enabled for a table. This attribute can be used to disable manual resizing for a particular column. It can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
sortingComparatorfalsejava.util.ComparatoronlynullA value-binding expression that should reference a comparator for comparing the values provided by the "sortingExpression" attribute. You can use a column data variable specified in the "var" in the expression for this attribute.
sortingEnabledfalsebooleantruetrueA flag that indicates whether or not each dynamic column is sortable. Can be specified right on the page (one and the same value for all dynamic columns is used) or as a value-binding expression. You can use a column data variable specified in the "var" in the expression for this attribute.
sortingExpressionfalsejava.lang.StringonlynullA value-binding expression that should reference a row's value that is used during sorting. You can use a column data variable specified in the "var" in the expression for this attribute. Specifying this attribute makes all dynamic columns to be sortable. Some dynamic columns can be made non-sortable by using the "sortingEnabled" attribute if needed.
stylefalsejava.lang.StringtruenullA style for the entire dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
styleClassfalsejava.lang.StringtruenullA CSS class name for the entire dynamic column. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
valignfalsejava.lang.StringtruenullThe vertical alignment of the dynamic column content. Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.
valuefalsearray,
java.util.Collection
onlynullSpecifies an array or a collection of objects that serve as column data objects. tag results in adding one column per each object found in this collection.
vartruejava.lang.StringfalsenullThe name of the request-scope variable under which the current column data object is available when evaluating value binding expressions specified in this tag's attributes.
widthfalsejava.lang.StringtruenullThe width of the dynamic column. Can be specified in any units (px, mm, em, etc.). Can be specified as a value-binding expression that uses a column data variable specified in the "var" attribute.

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.