function theme_pager_next

7.x pager.inc theme_pager_next($variables)
6.x pager.inc theme_pager_next($text, $limit, $element = 0, $interval = 1, $parameters = array())

Returns HTML for the "next page" link in a query pager.

Parameters

$variables: An associative array containing:

  • text: The name (or image) of the link.
  • 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.

Related topics

Default theme implementations
Functions and templates for the user interface to be implemented by themes.
Pager pieces
Theme functions for customizing pager elements.
1 theme call to theme_pager_next()
theme_pager in drupal-7.x/includes/pager.inc
Returns HTML for a query pager.

File

drupal-7.x/includes/pager.inc, line 519
Functions to aid in presenting database results as a set of pages.

Code

function theme_pager_next($variables) {
  $text = $variables['text'];
  $element = $variables['element'];
  $interval = $variables['interval'];
  $parameters = $variables['parameters'];
  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', array('text' => $text, 'element' => $element, 'parameters' => $parameters));
    }
    // The next page is not the last page.
    else {
      $output = theme('pager_link', array('text' => $text, 'page_new' => $page_new, 'element' => $element, 'parameters' => $parameters));
    }
  }

  return $output;
}