You are here

class PagersCacheContext in Drupal 10

Same name and namespace in other branches
  1. 8 core/lib/Drupal/Core/Cache/Context/PagersCacheContext.php \Drupal\Core\Cache\Context\PagersCacheContext
  2. 9 core/lib/Drupal/Core/Cache/Context/PagersCacheContext.php \Drupal\Core\Cache\Context\PagersCacheContext

Defines a cache context for "per page in a pager" caching.

Cache context ID: 'url.query_args.pagers' (to vary by all pagers). Calculated cache context ID: 'url.query_args.pagers:%pager_id', e.g. 'url.query_args.pagers:1' (to vary by the pager with ID 1).

Hierarchy

Expanded class hierarchy of PagersCacheContext

1 string reference to 'PagersCacheContext'
core.services.yml in core/core.services.yml
core/core.services.yml
1 service uses PagersCacheContext
cache_context.url.query_args.pagers in core/core.services.yml
Drupal\Core\Cache\Context\PagersCacheContext

File

core/lib/Drupal/Core/Cache/Context/PagersCacheContext.php, line 15

Namespace

Drupal\Core\Cache\Context
View source
class PagersCacheContext implements CalculatedCacheContextInterface {

  /**
   * The pager parameters.
   *
   * @var \Drupal\Core\Pager\PagerParametersInterface
   */
  protected $pagerParams;

  /**
   * Constructs a new PagersCacheContext object.
   *
   * @param \Drupal\Core\Pager\PagerParametersInterface $pager_params
   *   The pager parameters.
   */
  public function __construct(PagerParametersInterface $pager_params) {
    $this->pagerParams = $pager_params;
  }

  /**
   * {@inheritdoc}
   */
  public static function getLabel() {
    return t('Pager');
  }

  /**
   * {@inheritdoc}
   *
   * @see \Drupal\Core\Pager\PagerParametersInterface::findPage()
   */
  public function getContext($pager_id = NULL) {

    // The value of the 'page' query argument contains the information that
    // controls *all* pagers.
    if ($pager_id === NULL) {
      return $this->pagerParams
        ->getPagerParameter();
    }
    return $pager_id . '.' . $this->pagerParams
      ->findPage($pager_id);
  }

  /**
   * {@inheritdoc}
   */
  public function getCacheableMetadata($pager_id = NULL) {
    return new CacheableMetadata();
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PagersCacheContext::$pagerParams protected property The pager parameters.
PagersCacheContext::getCacheableMetadata public function Gets the cacheability metadata for the context based on the parameter value. Overrides CalculatedCacheContextInterface::getCacheableMetadata
PagersCacheContext::getContext public function Overrides CalculatedCacheContextInterface::getContext
PagersCacheContext::getLabel public static function Returns the label of the cache context. Overrides CalculatedCacheContextInterface::getLabel
PagersCacheContext::__construct public function Constructs a new PagersCacheContext object.