About Navigation Bars in Tables

In a table where a subset of a large set of data is displayed, a record navigation bar displays the user's current position among a block of records while allowing the user to navigate back and forth through the records via generated links.

Part of table with navigation bar enabled

For a table to render a navigation bar, you must set the following attributes on the table:

blockSize - Specifies the number of rows to display in a normal subset
value - Specifies the first index currently displayed in the table

In addition you can also set the minValue and maxValue attributes to specify the first and last possible values in the range of data displayed.

The links in the record navigation bar are generated URLs based on the destination attribute of the table. When the user clicks a link, the table generates a goto event with the following URL parameters:

source (source_param) - Identifies the table that generated the event. The value is the id attribute of the table.
value (value_param) - Identifies the set of rows that the user is currently viewing. It is set to be the index of the first row in the set.
size (size_param) - Identifies the size of the set of rows that is currently being viewed. This is usually the blockSize of the table.

If the formSubmitted attribute on the table is set to true, then form submission links will be generated instead. As a result, the following hidden fields are set in the form in which the table resides:

source field is set to the table component id
size field is set to the number of records to display in a normal block
value field is set to the requested value to display

When showAll is enabled in the table, a "Show All" option is displayed in the record navigation bar. This is only used if the maxValue attribute is set. If the number of row blocks is too large, showAll is automatically disabled.