Same name and namespace in other branches
  1. 4.6.x includes/pager.inc \theme_pager_next()
  2. 4.7.x includes/pager.inc \theme_pager_next()
  3. 6.x includes/pager.inc \theme_pager_next()
  4. 7.x 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

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 220
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;
}