C H A P T E R 31

Dataset Navigator

The Dataset Navigator component is a set of four command fields that enable pagination (navigation) control over a set of data through a container view, like a BasicViewBean, a BasicTiledView or a BasicContainerView. Each of the four command fields represents the four types of navigation: First, Previous, Next, and Last. The command fields can be configured to auto-hide or auto-disable when the operation would result in no change to the display. For example, if the last record is currently displayed, the Next and Last command fields would be hidden or disabled since there is no next record.

Property Name	Description	Notes
Auto Disable	Enables the command fields to auto hide/disable when the corresponding operation would not result in a difference in the displayed data.
Hide When Disabled	Prevents the display of the command fields that are in a disabled mode.	Dependent on Auto Disable
Name	The class name of the component.
Target Container View Path	The name of the ContainerView reference instance as declared in its parent (a ContainerView, TiledView, or ViewBean). This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path must refer to a ContainerView or a derivative of ContainerView (such as TiledView, ContainerView, or ViewBean or other custom or third party version derivative of these types). Both relative and absolute paths are possible. If a name path begins with a forward slash, the name is assumed to be relative to the root view (the ViewBean). If the path does not begin with a forward slash, the name is assumed to refer to a child relative to the current container. Two dots ("..") may be used to refer to the container that is the parent of the current container. Examples: `/header/orderList/customerName (absolute from root view)` `orderList/customerName (relative to current container)` `../footer/orderList/customerName (relative to parent)`