You are here

function theme_pager in Drupal 5

Same name and namespace in other branches
  1. 4 includes/pager.inc \theme_pager()
  2. 6 includes/pager.inc \theme_pager()
  3. 7 includes/pager.inc \theme_pager()

Format a query pager.

Menu callbacks that display paged query results should call theme('pager') to retrieve a pager control so that users can view other results.

Parameters

$tags: An array of labels for the controls in the pager.

$limit: The number of query results to display per page.

$element: An optional integer to distinguish between multiple pagers on one page.

$parameters: An associative array of query string parameters to append to the pager links.

Return value

An HTML string that generates the query pager.

Related topics

26 theme calls to theme_pager()
aggregator_page_list in modules/aggregator/aggregator.module
blog_page_last in modules/blog/blog.module
Displays a Drupal page containing recent blog entries of all users.
blog_page_user in modules/blog/blog.module
Displays a Drupal page containing recent blog entries of a given user.
comment_admin_overview in modules/comment/comment.module
comment_render in modules/comment/comment.module
Renders comment(s).

... See full list

File

includes/pager.inc, line 111
Functions to aid in presenting database results as a set of pages.

Code

function theme_pager($tags = array(), $limit = 10, $element = 0, $parameters = array()) {
  global $pager_total;
  $output = '';
  if ($pager_total[$element] > 1) {
    $output .= '<div class="pager">';
    $output .= theme('pager_first', $tags[0] ? $tags[0] : t('« first'), $limit, $element, $parameters);
    $output .= theme('pager_previous', $tags[1] ? $tags[1] : t('‹ previous'), $limit, $element, 1, $parameters);
    $output .= theme('pager_list', $limit, $element, $tags[2] ? $tags[2] : 9, '', $parameters);
    $output .= theme('pager_next', $tags[3] ? $tags[3] : t('next ›'), $limit, $element, 1, $parameters);
    $output .= theme('pager_last', $tags[4] ? $tags[4] : t('last »'), $limit, $element, $parameters);
    $output .= '</div>';
    return $output;
  }
}