1. class
  2. Drupal
  3. \
  4. Core
  5. \
  6. Pager
  7. \
  8. PagerParameters

PagerParameters

class PagerParameters implements PagerParametersInterface (View source)

Provides pager information contained within the current request.

Properties

protected RequestStack $requestStack

The HTTP request stack.

Methods

__construct(RequestStack $stack)

Construct a PagerManager object.

array
getQueryParameters()

Gets all request URL query parameters that are unrelated to paging.

int
findPage(int $pager_id = 0)

Returns the current page being requested for display within a pager.

int[]
getPagerQuery()

Gets the request query parameter.

string
getPagerParameter()

Gets the 'page' query parameter for the current request.

Details

at line 28
__construct(RequestStack $stack)

Construct a PagerManager object.

Parameters

RequestStack $stack

The current HTTP request stack.

at line 35
array getQueryParameters()

Gets all request URL query parameters that are unrelated to paging.

Return Value

array

A URL query parameter array that consists of all components of the current page request except for those pertaining to paging.

at line 48
int findPage(int $pager_id = 0)

Returns the current page being requested for display within a pager.

Parameters

int $pager_id

(optional) An integer to distinguish between multiple pagers on one page.

Return Value

int

The number of the current requested page, within the pager represented by $element. This is determined from the URL query parameter \Drupal::request()->query->get('page'), or 0 by default. Note that this number may differ from the actual page being displayed. For example, if a search for "example text" brings up three pages of results, but a user visits search/node/example+text?page=10, this function will return 10, even though the default pager implementation adjusts for this and still displays the third page of search results at that URL.

at line 56
int[] getPagerQuery()

Gets the request query parameter.

Return Value

int[]

Array of pagers. Keys are integers which are the element ID. Values are the zero-based current page from the request. The first page is 0, the second page is 1, etc.

at line 64
string getPagerParameter()

Gets the 'page' query parameter for the current request.

Return Value

string

The 'page' query parameter for the current request. This is a comma-delimited string of pager element values. Defaults to empty string if the query does not have a 'page' parameter.