Attributes |
Name | Required | Request-time | Type | Description |
binding | false | false | java.lang.String |
A ValueExpression that resolves to the UIComponent that corresponds
to this tag. This attribute allows the Java bean that contains the UIComponent
to manipulate the UIComponent, its properties, and its children.
|
spacerColumn | false | false | java.lang.String | Use the spacerColumn attribute to use the column as a blank column
to enhance spacing in two or three column tables. When the
spacerColumn attribute is true, the CSS styles applied to the
column make it appear as if the columns are justified. If a column header and
footer are required, provide an empty string for the headerText
and footerText attributes. Set the width attribute to
justify columns accordingly.
|
onDblClick | false | false | java.lang.String | Scripting code executed when a mouse double click
occurs over this component.
|
width | false | false | java.lang.String | Use the width attribute to specify the width of the cells of the
column. The width can be specified as the number of pixels or the percentage of
the table width, and is especially useful for spacer columns. This attribute is
deprecated in HTML 4.0 in favor of style sheets.
|
selectId | false | false | java.lang.String | Use the selectId attribute in select columns, which contain
checkboxes or radio buttons for selecting table rows. The value of
selectId must match the id attribute of the checkbox
or radioButton component that is a child of the tableColumn component. A fully
qualified ID based on the tableColumn component ID and the
selectId for the current row will be dynamically created for the
<input> element that is rendered for the checkbox or radio
button. The selectId is required for functionality that supports
the toggle buttons for selecting rows. The selectId also
identifies the column as a select column, for which the table component
uses different CSS styles.
|
sort | false | false | java.lang.String | Use the sort attribute to specify a FieldKey id or SortCriteria
that defines the criteria to use for sorting the contents of a
TableDataProvider. If SortCriteria is provided, the object is used for sorting
as is. If an id is provided, a FieldIdSortCriteria is created for sorting. In
addition, a value binding can also be used to sort on an object that is
external to TableDataProvider, such as the selected state of a checkbox or
radiobutton. When a value binding is used, a ValueBindingSortCriteria object
is created for sorting. All sorting is based on the object type associated with
the data element (for example, Boolean, Character, Comparator, Date, Number,
and String). If the object type cannot be determined, the object is compared as
a String. The sort attribute is required for a column to be shown
as sortable.
|
onKeyPress | false | false | java.lang.String | Scripting code executed when the user presses and releases a key while
the component has focus.
|
severity | false | false | java.lang.String | Use the severity attribute when including the webuijsf:alarm
component in a column, to match the severity of the alarm. Valid values are
described in the webuijsf:alarm documentation. When the
severity attribute is set in the tableColumn, the table
component renders sort tool tips to indicate that the column will be sorted
least/most severe first, and the table cell appears hightlighted according to
the level of severity. This functionality is overridden by the
emptyCell attribute.
|
rendered | false | false | java.lang.String | Use the rendered attribute to indicate whether the HTML code for the
component should be included in the rendered HTML page. If set to false,
the rendered HTML page does not include the HTML for the component. If
the component is not rendered, it is also not processed on any subsequent
form submission.
|
rowHeader | false | false | java.lang.String | Use the rowHeader attribute to specify that the cells of the
column are acting as row headers. Row headers are cells that "label" the row.
For example, consider a table where the first column contains checkboxes, and
the second column contains user names. The third and subsequent columns contain
attributes of those users. The content of the cells in the user name column are
acting as row headers. The webuijsf:tableColumn tag for the user name
column should set the rowHeader attribute to true. If a table
contains, for example, a system log with time stamp and log entry columns,
neither column is acting as a row header, so the rowHeader
attribute should not be set.
By default, most column cells are rendered by the table component with HTML
<td scope="col"> elements. The exceptions are columns that
contain checkboxes or radio buttons and spacer columns, all of which are
rendered as <td> elements without a scope property.
When you set the rowHeader attribute, the column cells are
rendered as <th scope="row"> elements, which enables
adaptive technologies such as screen readers to properly read the table to
indicate that the contents of these cells are headers for the rows.
|
id | false | true | java.lang.String | No Description |
onKeyUp | false | false | java.lang.String | Scripting code executed when the user releases a key while the
component has focus.
|
onMouseUp | false | false | java.lang.String | Scripting code executed when the user releases a mouse button while
the mouse pointer is on the component.
|
styleClass | false | false | java.lang.String | CSS style class(es) to be applied to the outermost HTML element when this
component is rendered.
|
descending | false | false | java.lang.String | Use the descending attribute to specify that the first
user-applied sort is descending. By default, the first time a user clicks a
column's sort button or column header, the sort is ascending. Note that this
not an initial sort. The data is initially displayed unsorted.
|
embeddedActions | false | false | java.lang.String | Set the embeddedActions attribute to true when the column includes
more than one embedded action. This attribute causes a separator image to be
displayed between the action links. This attribute is overridden by the
emptyCell attribute.
|
height | false | false | java.lang.String | The number of pixels for the cell's height. Styles should be used to specify
cell height when possible because the height attribute is deprecated in HTML 4.0.
|
footerText | false | false | java.lang.String | The text to be displayed in the column footer.
|
align | false | false | java.lang.String | Use the align attribute to specify the horizontal alignment for
the content of each cell in the column. Valid values are left ,
center , right , justify , and
char . The default alignment is left . Setting the
align attribute to char causes the cell's contents
to be aligned on the character that you specify with the char
attribute. For example, to align cell contents on colons, set
align="char" and char=":" Some browsers do not
support aligning on the character.
|
scope | false | false | java.lang.String | Use the scope attribute to specify that the data cells of the
column are also acting as headers for rows or other columns of the table.
This attribute supports assistive technologies by enabling them to determine
the order in which to read the cells. Valid values include:
row , when the cells provide header information for the row
col , when the cells provide header information for the column
rowgroup , when the cells provide header information for the row group
colgroup , when the cells provide header information for the column group
|
style | false | false | java.lang.String | CSS style(s) to be applied to the outermost HTML element when this
component is rendered.
|
sortImageURL | false | false | java.lang.String | Absolute or relative URL to the image used for the sort button that is
displayed in the column header.
|
onClick | false | false | java.lang.String | Scripting code executed when a mouse click
occurs over this component.
|
sortIcon | false | false | java.lang.String | The theme identifier to use for the sort button that is displayed in the column
header. Use this attribute to override the default image.
|
onMouseDown | false | false | java.lang.String | Scripting code executed when the user presses a mouse button while the
mouse pointer is on the component.
|
toolTip | false | false | java.lang.String | Sets the value of the title attribute for the HTML element.
The specified text will display as a tooltip if the mouse cursor hovers
over the HTML element.
|
alignKey | false | false | java.lang.String | Use the alignKey attribute to specify the FieldKey id or FieldKey
to be used as an identifier for a specific data element on which to align the
table cell data in the column. If alignKey specifies a
FieldKey, the FieldKey is used as is; otherwise, a FieldKey is created using
the alignKey value that you specify. Alignment is based on
the object type of the data element. For example, Date and Number objects are
aligned "right", Character and String objects are aligned "left", and Boolean
objects are aligned "center". All columns, including select columns, are
aligned "left" by default. Note that the align property overrides this value.
|
valign | false | false | java.lang.String | Use the valign attribute to specify the vertical alignment for the
content of each cell in the column. Valid values are top ,
middle , bottom , and baseline . The
default vertical alignment is middle . Setting the
valign attribute to baseline causes the first line of
each cell's content to be aligned on the text baseline, the invisible line on
which text characters rest.
|
noWrap | false | false | java.lang.String | Use the noWrap attribute to disable word wrapping of this column's
cells in visual browsers. Word wrap can cause unnecessary horizontal scrolling
when the browser window is small in relation to the font size. Styles
should be used to disable word wrap when possible because the nowrap attribute
is deprecated in HTML 4.0.
|
onMouseOut | false | false | java.lang.String | Scripting code executed when a mouse out movement
occurs over this component.
|
onMouseOver | false | false | java.lang.String | Scripting code executed when the user moves the mouse pointer into
the boundary of this component.
|
onMouseMove | false | false | java.lang.String | Scripting code executed when the user moves the mouse pointer while
over the component.
|
emptyCell | false | false | java.lang.String | Use the emptyCell attribute to cause a theme-specific image to be
displayed when the content of a table cell is not applicable or is unexpectedly
empty. You should not use this attribute for a value that is truly null, such
as an empty alarm cell or a comment field that is blank. In addition, the image
should not be used for cells that contain user interface elements such as
checkboxes or drop-down lists when these elements are not applicable. Instead,
the elements should simply not be displayed so the cell is left empty.
|
visible | false | false | java.lang.String | Use the visible attribute to indicate whether the component should be
viewable by the user in the rendered HTML page. If set to false, the
HTML code for the component is present in the page, but the component
is hidden with style attributes. By default, visible is set to true, so
HTML for the component HTML is included and visible to the user. If the
component is not visible, it can still be processed on subsequent form
submissions because the HTML is present.
|
onKeyDown | false | false | java.lang.String | Scripting code executed when the user presses down on a key while the
component has focus.
|
headerText | false | false | java.lang.String | The text to be displayed in the column header.
|