Portlet Factory, Version 6.1.2

 

Paging Buttons builder inputs

This topic describes the inputs for the Paging Buttons builder.

 

General inputs

Table 1. General inputs
Input Name Description
Name Name for this builder call. The WebSphere Portlet Factory Designer displays this name in the builder call list.
Page Location Page or pages on which this builder call acts.
Assistant Name The name of the Data Paging Assistant builder to use as a data source.
Use Links Enable this input to embed a link within the button.
Maximum Links This input is displayed when the Use Links input is enabled.

Enter an upper limit on number of links to show.

Range Text Format Use this input to control the formatting and contents of the range of displayed pages or records. For this input you can specify an indirect reference, enter a value directly, or select one of the following from the list:

{start}, {end}, {count}

For the currently displayed records.

{page} and {page_count}

To display things in terms of pages.

The value of this input has placeholders in it that get replaced with the current values from the Paging Assistant builder. An indirect reference is presumed to return this format, too.

Note: An empty string or null can be used to display nothing for the range.

Submit Form Enable this input to submit a form when the button is clicked.

 

First Button Images

Table 2. First Button Images inputs
Input Name Description
(optional) Normal button image Button image for "first page" button
(optional) Hover image Hover button image for "first page" button
(optional) Pressed image Pressed button image for "first page" button
(optional) Disabled image Disabled button image for "first page" button
Image Size Settings See Image Size Settings.

 

Prev Button Images

Table 3. Prev Button Images inputs
Input Name Description
(optional) Normal button image Button image for "previous page" button
(optional) Hover image Hover button image for "previous page" button
(optional) Pressed image Pressed button image for "previous page" button
(optional) Disabled image Disabled button image for "previous page" button
Image Size Settings See Image Size Settings.

 

Next Button Images

Table 4. Next Button Images inputs
Input Name Description
(optional) Normal button image Button image for "next page" button
(optional) Hover image Hover button image for "next page" button
(optional) Pressed image Pressed button image for "next page" button
(optional) Disabled image Disabled button image for "next page" button
Image Size Settings See Image Size Settings.

 

Last Button Images

Table 5. Last Button Images inputs
Input Name Description
(optional) Normal button image Button image for "last page" button
(optional) Hover image Hover button image for "last page" button
(optional) Pressed image Pressed button image for "last page" button
(optional) Disabled image Disabled button image for "last page" button
Image Size Settings See Image Size Settings.

 

Image Size Settings

Table 6. Image Size Settings inputs
Input Name Description
Image Width Width (in pixels) of this image
Image Height Height (in pixels) of this image
Alt Text Text displayed if image is not available

 

Unbounded Behavior

The inputs in this section describe how to provide paging buttons when the size of the data set on the backend is so large that it cannot be retrieved.

Table 7. Unbounded Behavior inputs
Input Name Description
Range Text Format Similar to the same input provided above, except that you use this input to control the formatting and contents of the range of displayed pages/records when the total number of records cannot be retrieved from the backend. For this input you can specify an indirect reference, enter a value directly, or select one of the following from the list:

{start}, {end}

For the currently displayed records

{page}

To display things in terms of pages.
Last Button Enablement Determines if the Last button is available in the case where the last records cannot be retrieved.

Always enable

Always enable the last button so the user can attempt to retrieve the record. This causes the Paging Assistant to sequentially retrieve each page of data. If the data set size is very large, this may take a very long time, appearing to hang. This option should be used only if the data set is known to be of a reasonable size.

Disable if data size is unknown

Disable the button if the data size cannot be determined. This is the default.

 

Advanced

Table 8. Advanced inputs
Input Name Description
(optional) HTML Page

HTML file to use as Imported Page base instead of default HTML.

Make URLs Absolute Enable this input whenever the HTML has relative URLs, whether or not this is a local file.

Disable this input if you are using a page that references other web sites so that external links will work.

Parent topic: Paging Buttons builder

Library | Support |