theme_pager_next

Versions

5 – 6

theme_pager_next($text, $limit, $element = 0, $interval = 1, $parameters = array())

7

theme_pager_next($variables)

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.

Code

5/includes/pager.inc, line 220

<?php
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);
    }
    // The next page is not the last page.
    else {
      $output = theme('pager_link', $text, $page_new, $element, $parameters, array('class' => 'pager-next'));
    }
  }

  return $output;
}
?>