| Tag Summary |
| pageLinks | This JSP Tag is used to render pagination navigation links (e.g. Previous Next 1 2 3 4 5 6 7 8 First Last). Layout of the links is configurable via injecting different implementation instance of org.hdpagination.config.PageLinksPattern interface into org.hdpagination.config.GlobalConfig. There are some pattern implementation classes available to choose in package 'org.hdpagination.config.pattern'. |
| pagesDropdown | This JSP Tag is used to render a dropdown (<select>) with all available pages, which allows the user to navigate to different pages. |
| gotoPage | This JSP Tag is used to render a text box along with either a submit button, hyperlink, or image link. The button, hyperlink, or image link is used to submit the request and navigate to the page specified in the text box. The decision to render the button, hyperlink, or image link relies on the following rule: If property 'imgSrc' is specified, then an image link (<img> tag with enclosing <a> tag) is rendered. Otherwise, if property 'linkLabel' is specified, the hyperlink (text with enclosing tag <a>) is rendered. If none of these are specified, the button is rendered by default. |
| sortBy | This JSP Tag is used to apply a hyperlink (<a>) to the column header in the search results table. This allows the user to sort the search results by this column. By default, when the column header is clicked and the current search result is not sorted by that column, then the result will be displayed in ascending order. The search results will be toggled between ascending and descending order every time the column header is clicked. |
| paginationRequired | This JSP tag is used as an outer tag of other pagination information display tags ('currentPage', 'totalPages', 'totalRecords' and 'recordScope'). The purpose of this tag is to check if search result can fit within one page. If that's the case, then its enclosed content(including what is generated by the enclosed tags) will not be rendered. |
| currentPage | This JSP Tag is used to display the current page number (or called index of the current page). The index starts from 1 - that is, it displays 1 for the first page. |
| totalPages | This JSP Tag is used to display the count of pages - that is, how many pages of records in the search results. |
| totalRecords | This JSP Tag is used to display the count of total records in the search results. |
| recordScope | This JSP tag is used to display the scope of records in current page - that is, index (starting from 1) of the first and last records in the current page. For example, if the page size is defined to 10, then it will display "11 - 20" for the second page if there are more than (including) 20 records totally in the search result. |
| errors | This JSP Tag is used to display validation error messages. |
| selectSortBy | This tag is used to render a dropdown (<select>) to allow the user to sort the search results by specified column in either ascending or descending order. This tag is an alternative of the 'sortBy' tag which applies a sorting hyperlink to the column header in a search results table. This tag can be useful in some cases where there is no column header in the search results table (as a result you can not apply the 'sortBy' tag to the column header). The 'selectSortBy' tag should be used together with 'sortByOption' tag. 'sortByOption' tags should be nested inside 'selectSortBy' tag and each 'sortByOption' will render as a <option> HTML tag. |
| sortByOption | This tag ('sortByOption') is a selection item (<option>) and must be nested inside the 'selectSortBy' Tag. It renders this selection item (<option>) for the dropdown (<select>). |