webuijsf
Tag table2


Component that represents a table.


Tag Information
Tag Classcom.sun.webui.jsf.component.Table2Tag
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.
htmlTemplatefalsefalsejava.lang.String Alternative HTML template to be used by this component.
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 table. The width can be specified as the number of pixels or the percentage of the page width, and is especially useful for spacer columns. This attribute is deprecated in HTML 4.0 in favor of style sheets.
titlefalsefalsejava.lang.String The text displayed for the table title.
onKeyPressfalsefalsejava.lang.String Scripting code executed when the user presses and releases a key while the component has focus.
deselectMultipleButtonOnClickfalsefalsejava.lang.String Scripting code that is executed when the user clicks the deselect multiple button. You should use the JavaScript setTimeout() function to invoke the script to ensure that checkboxes are deselected immediately, instead of waiting for the script to complete.
clearSortButtonfalsefalsejava.lang.String In the View-Changing Controls area of the Action Bar, display a button that clears any sorting of the table. When the button is clicked, the table items return to the order they were in when the page was initially rendered.
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.
filterIdfalsefalsejava.lang.String The element id to be applied to the outermost HTML element that is rendered for the dropDown component used to display filter options. The id must be fully qualified. This id is required for JavaScript functions to set the dropDown styles when the embedded filter panel is opened, and to reset the default selected value when the panel is closed. Note that if you use the webuijsf:dropDown tag as the only component in the filter facet, the filterId is optional. If you use a custom component, or use the webuijsf:dropDown as a child component, you must specify a filterID.
idfalsetruejava.lang.StringNo Description
hiddenSelectedRowsfalsefalsejava.lang.String Flag indicating that selected rows might be currently hidden from view. UI guidelines recommend that rows that are not in view are deselected. For example, when users select rows of the table and navigate to another page, the selected rows should be deselected automatically. Or, when a user applies a filter or sort that hides previously selected rows from view, those selected rows should be deselected. By deselecting hidden rows, you prevent the user from inadvertantly invoking an action on rows that are not displayed.

However, sometimes state must be maintained aross table pages. If your table must maintain state, you must set the hiddenSelectedRows attribute to true. The attribute causes text to be displayed in the table title and footer to indicate the number of selected rows that are currently hidden from view. This title and footer text is also displayed with a count of 0 when there are no hidden selections, to make the user aware of the possibility of hidden selections.

Note: When hiddenSelectedRows is false, the descending sort button for the select column is disabled when the table is paginated. Disabling this button prevents a sort from placing selected rows on a page other than the current page.

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.
deselectMultipleButtonfalsefalsejava.lang.String In the Action Bar, display a deselect button for tables in which multiple rows can be selected, to allow users to deselect all table rows that are currently displayed. This button is used to deselect a column of checkboxes using the id that was given to the selectId attribute of the webuijsf:tableColumn and webuijsf:table2Column tags.
filterPanelFocusIdfalsefalsejava.lang.String The element id used to set focus when the filter panel is open.
augmentTitlefalsefalsejava.lang.String Flag indicating that the table title should be augmented with the range of items currently displayed and the total number of items in the table. For example, "(1 - 25 of 200)". If the table is not currently paginated, the title is augmented with the number of displayed items. For example, "(18)". When set to false, any values set for itemsText and filterText are overridden.
litefalsefalsejava.lang.String Renders the table in a style that makes the table look lighter weight, generally by omitting the shading around the table and in the title bar.
stylefalsefalsejava.lang.String CSS style(s) to be applied to the outermost HTML element when this component is rendered.
cellSpacingfalsefalsejava.lang.String

The amount of whitespace that should be placed between cells, and between the edges of the table content area and the sides of the table. The default value is 0, which causes a default amount of space to be used.

All browsers support specifying the number of pixels to use for cell spacing, so you should specify a number of pixels to achieve consistency across platforms. Some browsers also support specifying the cell spacing as a percentage of the space available for spacing, and the calculated space is split evenly between the sides. Most browsers that do not support percentages treat cellspacing="20%" as if it were cellspacing="20".

onClickfalsefalsejava.lang.String Scripting code executed when a mouse click occurs over this component.
filterTextfalsefalsejava.lang.String Text to be inserted into the table title bar when a filter is applied. This text is expected to be the name of the filter that the user has selected. The attribute value should be a JavaServer Faces EL expression that resolves to a backing bean property whose value is set in your filter code. The value of the filterText attribute is inserted into the table title, as follows: Your Table's Title filterText Filter Applied.
paginationControlsfalsefalsejava.lang.String Show the table pagination controls, which allow users to change which page is displayed. The controls include an input field for specifying the page number, a Go button to go to the specified page, and buttons for going to the first, last, previous, and next page.
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.
sortPanelFocusIdfalsefalsejava.lang.String The element id used to set focus when the sort panel is open.
summaryfalsefalsejava.lang.String Text that describes this table's purpose and structure, for user agents rendering to non-visual media such as speech and Braille.
sortPanelToggleButtonfalsefalsejava.lang.String Show the button that is used to open and close the sort panel.
selectMultipleButtonfalsefalsejava.lang.String Show the button that is used for selecting multiple rows. The button is displayed in the Action Bar (top), and allows users to select all rows currently displayed. The button selects a column of checkboxes using the id specified in the selectId attribute of the webuijsf:tableColumn and webuijsf:table2Column tags.
preferencesPanelFocusIdfalsefalsejava.lang.String The element id used to set focus when the preferences panel is open.
onMouseOutfalsefalsejava.lang.String Scripting code executed when a mouse out movement occurs over this component.
paginateButtonfalsefalsejava.lang.String Show table paginate button to allow users to switch between viewing all data on a single page (unpaginated) or to see data in multiple pages (paginated).
selectMultipleButtonOnClickfalsefalsejava.lang.String Scripting code executed when the user clicks the mouse on the select multiple button.
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.
cellPaddingfalsefalsejava.lang.String

The amount of whitespace that should be placed between the cell contents and the cell borders, on all four sides of the cell. The default value is 0, which causes a default amount of space to be used.

All browsers support specifying the number of pixels to use for cell padding, so you should specify a number of pixels to achieve consistency across platforms. Some browsers also support specifying the cell padding as a percentage of the space available for padding, and the calculated space is split evenly between the sides. Most browsers that do not support percentages treat cellpadding="20%" as if it were cellpadding="20".

deselectSingleButtonOnClickfalsefalsejava.lang.String Scripting code that is executed when the user clicks the deselect single button. You should use the JavaScript setTimeout() function to invoke the script to ensure that the radio button is deselected immediately, instead of waiting for the script to complete.
itemsTextfalsefalsejava.lang.String Text to add to the title of an unpaginated table. For example, if your table title is "Critical" and there are 20 items in the table, the default unpaginated table title would be Critical (20). If you specify itemsText="alerts", the title would be Critical (20 alerts).
deselectSingleButtonfalsefalsejava.lang.String In the Action Bar, display a deselect button for tables in which only a single table row can be selected at a time. This button is used to deselect a column of radio buttons using the id that was given to the selectId attribute of the webuijsf:tableColumn and webuijsf:table2Column tags.
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.
tabIndexfalsefalsejava.lang.String Position of this element in the tabbing order of the current document. Tabbing order determines the sequence in which elements receive focus when the tab key is pressed. The value must be an integer between 0 and 32767.

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.