You are here

Home » API reference » Drupal 4 » pager.inc

function theme_pager_next in Drupal 4

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

Format a "next page" link.

Parameters

$text: The name (or image) of the link.

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

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

$interval: The number of pages to move forward when the link is clicked.

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

Return value

An HTML string that generates this piece of the query pager.

Related topics

Themeable functions
Functions that display HTML, and which can be customized by themes.
2 theme calls to theme_pager_next()
theme_pager in includes/pager.inc
Format a query pager.
theme_pager_list in includes/pager.inc
Format a list of nearby pages with additional query results.

File

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

Code

function theme_pager_next($text, $limit, $element = 0, $interval = 1, $parameters = array()) {
  global $pager_page_array, $pager_total;
  $output = '';

  // If we are anywhere but the last page
  if ($pager_page_array[$element] < $pager_total[$element] - 1) {
    $page_new = pager_load_array($pager_page_array[$element] + $interval, $element, $pager_page_array);

    // If the next page is the last page, mark the link as such.
    if ($page_new[$element] == $pager_total[$element] - 1) {
      $output = theme('pager_last', $text, $limit, $element, $parameters);
    }
    else {
      $output = theme('pager_link', $text, $page_new, $element, $parameters, array(
        'class' => 'pager-next',
      ));
    }
  }
  return $output;
}