C H A P T E R 33

datasetNavigator

<jatox:datasetNavigator>

Renders four graphical buttons that represent the four dataset navigation actions: First, Previous, Next and Last. The actions work against the targeted container view that is configured in the component. This tag is only valid when nested inside of a useViewBean or containerView or tiledView tag body, although, it typically will not be used inside a tiledView tag.

The First and Previous buttons can be displayed as disabled or hidden (not displayed at all) when the first record displayed is determined to be the first record in the dataset. Same goes for the Next and Last buttons when it is determined that the last record (no more records) is being displayed. If for some reason no data was returned, the text (no data found) will be displayed instead of the buttons.

This tag is only valid when enclosed by both an HTML <form> element and a useViewBean, containerView, or tiledView tag. This tag may not contain any body content.

Example:

<jatox:datasetNavigator name="datasetNavigator1"> <jato:containerView name="datasetNavigator1"> <%@ include file="/com/sun/jatox/view/DatasetNavigator.jsp" %> </jato:containerView> </jatox:datasetNavigator>

The above would be rendered into the following various forms of HTML (bold indicates enabled, non-bold indicates diabled):

1. [<<] [<] [>] [>>]

2. [<<] [<] [>] [>>]

3. [<<] [<] [>] [>>]

4. [<<] [<]

5. [>] [>>]

The included file is a precomposed pagelet that can be customized with some limits. Tweaking the wrong tag could produce undesired or unpredictable behavior. It is encouraged that only static content be modified or additional HTML markup be added when customizing this file.

Attribute Name	Description	Notes
name	The name of the `DisplayField` peer. This peer must be a child of the current parent `ContainerView`, `TiledView`, or `ViewBean`. The DisplayField name is resolved relative to the current parent view. The view peer must be of type `<JATOX package>.view.`DatasetLocator This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path except the last must refer to a `ContainerView` or a derivative of `ContainerView` (such as `TiledView`). 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)	Req
	This tag does not support any JavaScript events.

Attribute Name

Description

Notes

name

The name of the DisplayField peer. This peer must be a child of the current parent ContainerView, TiledView, or ViewBean. The DisplayField name is resolved relative to the current parent view.

The view peer must be of type <JATOX package>.view.DatasetLocator

This name may be a qualified view path, using forward slashes ("/") as delimiters. All components in the path except the last must refer to a ContainerView or a derivative of ContainerView (such as TiledView). 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)

Req

This tag does not support any JavaScript events.