function theme_pager_link

Same name and namespace in other branches
  1. 7.x drupal-7.x/includes/pager.inc \theme_pager_link()

Returns HTML for a link to a specific query result page.

Parameters

$text: The link text. Also used to figure out the title attribute of the link, if it is not provided in $attributes['title']; in this case, $text must be one of the standard pager link text strings that would be generated by the pager theme functions, such as a number or t('« first').

$page_new: The first result to display on the linked page.

$element: An optional integer to distinguish between multiple pagers on one page.

$parameters: An associative array of query string parameters to append to the pager link.

$attributes: An associative array of HTML attributes to apply to the pager link.

Return value

An HTML string that generates the link.

Related topics

Default theme implementations
Functions and templates that present output to the user, and can be implemented by themes.
Pager pieces
Theme functions for customizing pager elements.
4 theme calls to theme_pager_link()
theme_pager_first in drupal-6.x/includes/pager.inc
Returns HTML for a "first page" link.
theme_pager_last in drupal-6.x/includes/pager.inc
Returns HTML for a "last page" link.
theme_pager_next in drupal-6.x/includes/pager.inc
Returns HTML for a "next page" link.
theme_pager_previous in drupal-6.x/includes/pager.inc
Returns HTML for a "previous page" link.

Archivo

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

Código

function theme_pager_link($text, $page_new, $element, $parameters = array(), $attributes = array()) {
  $page = isset($_GET['page']) ? $_GET['page'] : '';
  if ($new_page = implode(',', pager_load_array($page_new[$element], $element, explode(',', $page)))) {
    $parameters['page'] = $new_page;
  }

  $query = array();
  if (count($parameters)) {
    $query[] = drupal_query_string_encode($parameters, array());
  }
  $querystring = pager_get_querystring();
  if ($querystring != '') {
    $query[] = $querystring;
  }

  // Set each pager link title
  if (!isset($attributes['title'])) {
    static $titles = NULL;
    if (!isset($titles)) {
      $titles = array(
        t('« first') => t('Go to first page'),
        t('‹ previous') => t('Go to previous page'),
        t('next ›') => t('Go to next page'),
        t('last »') => t('Go to last page'),
      );
    }
    if (isset($titles[$text])) {
      $attributes['title'] = $titles[$text];
    }
    else if (is_numeric($text)) {
      $attributes['title'] = t('Go to page @number', array('@number' => $text));
    }
  }

  return l($text, $_GET['q'], array('attributes' => $attributes, 'query' => count($query) ? implode('&', $query) : NULL));
}