MenuActiveTrailsCacheContext.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/Cache/Context/MenuActiveTrailsCacheContext.php
  2. 8.9.x core/lib/Drupal/Core/Cache/Context/MenuActiveTrailsCacheContext.php
  3. 11.x core/lib/Drupal/Core/Cache/Context/MenuActiveTrailsCacheContext.php

Namespace

Drupal\Core\Cache\Context

File

core/lib/Drupal/Core/Cache/Context/MenuActiveTrailsCacheContext.php

View source
<?php

namespace Drupal\Core\Cache\Context;

use Drupal\Core\Cache\CacheableMetadata;
use Drupal\Core\Menu\MenuActiveTrailInterface;

/**
 * Defines the MenuActiveTrailsCacheContext service.
 */
class MenuActiveTrailsCacheContext implements CalculatedCacheContextInterface {
    
    /**
     * Constructs a MenuActiveTrailsCacheContext object.
     *
     * @param \Drupal\Core\Menu\MenuActiveTrailInterface|null $menuActiveTrailService
     *   The menu active trail service.
     */
    public function __construct(?MenuActiveTrailInterface $menuActiveTrailService = NULL) {
        if ($this->menuActiveTrailService === NULL) {
            @trigger_error('Calling ' . __METHOD__ . ' without the $menuActiveTrailService argument is deprecated in drupal:10.2.0 and it will be required in drupal:11.0.0. See https://www.drupal.org/node/3397515', E_USER_DEPRECATED);
            $this->menuActiveTrailService = \Drupal::service('menu.active_trail');
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public static function getLabel() {
        return t("Active menu trail");
    }
    
    /**
     * {@inheritdoc}
     */
    public function getContext($menu_name = NULL) {
        if (!$menu_name) {
            throw new \LogicException('No menu name provided for menu.active_trails cache context.');
        }
        $active_trail = $this->menuActiveTrailService
            ->getActiveTrailIds($menu_name);
        return 'menu_trail.' . $menu_name . '|' . implode('|', $active_trail);
    }
    
    /**
     * {@inheritdoc}
     */
    public function getCacheableMetadata($menu_name = NULL) {
        if (!$menu_name) {
            throw new \LogicException('No menu name provided for menu.active_trails cache context.');
        }
        $cacheable_metadata = new CacheableMetadata();
        return $cacheable_metadata->setCacheTags([
            "config:system.menu.{$menu_name}",
        ]);
    }

}

Classes

Title Deprecated Summary
MenuActiveTrailsCacheContext Defines the MenuActiveTrailsCacheContext service.

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