The Table Layout dialog box enables you to specify the layout and contents of a Table component. You open the dialog box by right-clicking a Table component in the Visual Designer and choosing Table Layout.
This dialog box is especially useful if you have added a database table to the current page, as described in Adding Tablesto a Visual Web JSF Page. You can use the Get Data From drop down list in the Columns tab to see a list of appropriate objects that are in scope, such as the data provider for a database table that you previously dropped on the page.
When the dialog box opens, the Columns tab is selected. If you dropped a table directly on the Table component, you see the table's columns and fields in the dialog box, and you see the name of the table's data provider in the Get Data From field. If you did not drop a table on the Table component (for example, you dropped it on the page), you can use the dialog box's Get Data From drop down list to pick the data provider.
The dialog box has the following tabs and fields:
When you select a table data provider from the Get Data From drop down list, the available columns appear in the Available
list. However, when you select an array or List
,
the IDE does not know what kinds of objects will be
in that array or List
at runtime, so nothing
appears in the Available list. Instead, you must use
the Value Expression field to specify a JavaServer Faces expression
for that column. The expression should be relative to
the currentRow (begins with #{currentRow
),
but the IDE accepts any valid JavaServer Faces expression that can
be resolved at design time. You can add new columns
to the table with the New button.
#{currentRow
), but the IDE accepts any valid
JavaServer Faces expression that can be resolved at design time.<td>
tag's align
parameter. <td>
tag's valign
parameter. title
property, which determines the title displayed at the top of the table. summary
property, which provides information about the Table's purpose or structure or both that is readable by a screen reader. footerText
property, which determines the footer text displayed at the bottom of the table.selectMultipleButton
property, which displays a button that the user can click to check an entire column of checkboxes, selecting all rows in the table.deselectMultipleButton
property, which displays a button that the user can click to uncheck an entire column of checkboxes, deselecting all rows in the table. clearSortButton
property, which displays a Clear Table Sort button that the user can click to remove all sorting currently applied to the table, returning the table items to the order they were in when the page was initially rendered. sortPanelToggleButton
property, which displays a button that the user can click to open and close the table's Sort panel.paginateButton
- Displays a button that enables users to switch between viewing all data on a single page, an unpaginated table, and seeing data in multiple pages, a paginated table.paginationControls
- Displays table pagination controls that enable 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