function theme_pager_first

Returns HTML for the "first 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.
  • parameters: An associative array of query string parameters to append to the pager links.

Related topics

2 theme calls to theme_pager_first()
theme_pager in includes/pager.inc
Returns HTML for a query pager.
theme_pager_previous in includes/pager.inc
Returns HTML for the "previous page" link in a query pager.

File

includes/pager.inc, line 476

Code

function theme_pager_first($variables) {
    $text = $variables['text'];
    $element = $variables['element'];
    $parameters = $variables['parameters'];
    global $pager_page_array;
    $output = '';
    // Nothing to do if there is no pager.
    if (!isset($pager_page_array[$element])) {
        return;
    }
    // If we are anywhere but the first page
    if ($pager_page_array[$element] > 0) {
        $output = theme('pager_link', array(
            'text' => $text,
            'page_new' => pager_load_array(0, $element, $pager_page_array),
            'element' => $element,
            'parameters' => $parameters,
        ));
    }
    return $output;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.