Home › API reference › pager.inc

theme_pager_previous

  1. drupal
    1. 4.7 pager.inc
    2. 5 pager.inc
    3. 6
    4. 7
Versions
4.7 – 6 theme_pager_previous($text, $limit, $element = 0, $interval = 1, $parameters = array())
7 theme_pager_previous($variables)

Returns HTML for the "previous 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 backward 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
Use these pieces to construct your own custom pagers in your theme.

Code

drupal/includes/pager.inc, line 481

<?php
function theme_pager_previous($variables) {
  $text = $variables['text'];
  $element = $variables['element'];
  $interval = $variables['interval'];
  $parameters = $variables['parameters'];
  global $pager_page_array;
  $output = '';

  // If we are anywhere but the first page
  if ($pager_page_array[$element] > 0) {
    $page_new = pager_load_array($pager_page_array[$element] - $interval, $element, $pager_page_array);

    // If the previous page is the first page, mark the link as such.
    if ($page_new[$element] == 0) {
      $output = theme('pager_first', array('text' => $text, 'element' => $element, 'parameters' => $parameters));
    }
    // The previous page is not the first page.
    else {
      $output = theme('pager_link', array('text' => $text, 'page_new' => $page_new, 'element' => $element, 'parameters' => $parameters));
    }
  }

  return $output;
}
?>