webuijsf
Tag table2Column


Component that represents a table column.


Tag Information
Tag Classcom.sun.webui.jsf.component.Table2ColumnTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.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.
spacerColumnfalsefalsejava.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.
onDblClickfalsefalsejava.lang.String Scripting code executed when a mouse double click occurs over this component.
widthfalsefalsejava.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.
selectIdfalsefalsejava.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.
sortfalsefalsejava.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.
onKeyPressfalsefalsejava.lang.String Scripting code executed when the user presses and releases a key while the component has focus.
severityfalsefalsejava.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.
renderedfalsefalsejava.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.
rowHeaderfalsefalsejava.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.

idfalsetruejava.lang.StringNo Description
onKeyUpfalsefalsejava.lang.String Scripting code executed when the user releases a key while the component has focus.
onMouseUpfalsefalsejava.lang.String Scripting code executed when the user releases a mouse button while the mouse pointer is on the component.
styleClassfalsefalsejava.lang.String CSS style class(es) to be applied to the outermost HTML element when this component is rendered.
descendingfalsefalsejava.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.
embeddedActionsfalsefalsejava.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.
heightfalsefalsejava.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.
footerTextfalsefalsejava.lang.String The text to be displayed in the column footer.
alignfalsefalsejava.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.
scopefalsefalsejava.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
stylefalsefalsejava.lang.String CSS style(s) to be applied to the outermost HTML element when this component is rendered.
sortImageURLfalsefalsejava.lang.String Absolute or relative URL to the image used for the sort button that is displayed in the column header.
onClickfalsefalsejava.lang.String Scripting code executed when a mouse click occurs over this component.
sortIconfalsefalsejava.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.
onMouseDownfalsefalsejava.lang.String Scripting code executed when the user presses a mouse button while the mouse pointer is on the component.
toolTipfalsefalsejava.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.
alignKeyfalsefalsejava.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.
valignfalsefalsejava.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.
noWrapfalsefalsejava.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.
onMouseOutfalsefalsejava.lang.String Scripting code executed when a mouse out movement occurs over this component.
onMouseOverfalsefalsejava.lang.String Scripting code executed when the user moves the mouse pointer into the boundary of this component.
onMouseMovefalsefalsejava.lang.String Scripting code executed when the user moves the mouse pointer while over the component.
emptyCellfalsefalsejava.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.
visiblefalsefalsejava.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.
onKeyDownfalsefalsejava.lang.String Scripting code executed when the user presses down on a key while the component has focus.
headerTextfalsefalsejava.lang.String The text to be displayed in the column header.

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.