function theme_pager_next

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

@since 1.35.1 Added fragment property.

Parameters

array $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.
• fragment: An optional string for URL anchor.

Related topics

File

core/includes/pager.inc, line 430

Functions to aid in presenting database results as a set of pages.

Code

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

  return $output;
}