You are here

trait AssertMenuActiveTrailTrait in Drupal 10

Same name and namespace in other branches
  1. 8 core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait
  2. 9 core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait

Provides test assertions for verifying the active menu trail.

Hierarchy

File

core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php, line 10

Namespace

Drupal\Tests\system\Functional\Menu
View source
trait AssertMenuActiveTrailTrait {

  /**
   * Assert that active trail exists in a menu tree output.
   *
   * @param array $tree
   *   An associative array whose keys are link paths and whose
   *   values are link titles (not sanitized) of an expected active trail in a
   *   menu tree output on the page.
   * @param bool $last_active
   *   Whether the last link in $tree is expected to be active (TRUE)
   *   or just to be in the active trail (FALSE).
   * @param string $active_trail_class
   *   (optional) The class of the active trail. Defaults to
   *   'menu-item--active-trail'.
   * @param string $active_class
   *   (optional) The class of the active element. Defaults to 'is-active'.
   */
  protected function assertMenuActiveTrail($tree, $last_active, $active_trail_class = 'menu-item--active-trail', $active_class = 'is-active') {
    end($tree);
    $active_link_path = key($tree);
    $active_link_title = array_pop($tree);
    $xpath = '';
    if ($tree) {
      $i = 0;
      foreach ($tree as $link_path => $link_title) {
        $part_xpath = !$i ? '//' : '/following-sibling::ul/descendant::';
        $part_xpath .= 'li[contains(@class, :class-trail)]/a[contains(@href, :href) and contains(text(), :title)]';
        $part_args = [
          ':class-trail' => $active_trail_class,
          ':href' => Url::fromUri('base:' . $link_path)
            ->toString(),
          ':title' => $link_title,
        ];
        $xpath .= $this
          ->assertSession()
          ->buildXPathQuery($part_xpath, $part_args);
        $i++;
      }
      $elements = $this
        ->xpath($xpath);
      $this
        ->assertNotEmpty($elements, 'Active trail to current page should be visible in menu tree.');

      // Append prefix for active link asserted below.
      $xpath .= '/following-sibling::ul/descendant::';
    }
    else {
      $xpath .= '//';
    }
    $xpath_last_active = $last_active ? 'and contains(@class, :class-active)' : '';
    $xpath .= 'li[contains(@class, :class-trail)]/a[contains(@href, :href) ' . $xpath_last_active . 'and contains(text(), :title)]';
    $args = [
      ':class-trail' => $active_trail_class,
      ':class-active' => $active_class,
      ':href' => Url::fromUri('base:' . $active_link_path)
        ->toString(),
      ':title' => $active_link_title,
    ];
    $elements = $this
      ->xpath($xpath, $args);
    $this
      ->assertNotEmpty($elements, sprintf('Active link %s should be visible in menu tree, including active trail links %s.', $active_link_title, implode(' » ', $tree)));
  }

}

Members

Namesort descending Modifiers Type Description Overrides
AssertMenuActiveTrailTrait::assertMenuActiveTrail protected function Assert that active trail exists in a menu tree output.