function AssertMenuActiveTrailTrait::assertMenuActiveTrail

Same name in this branch
  1. 8.9.x core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait::assertMenuActiveTrail()
Same name in other branches
  1. 9 core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait::assertMenuActiveTrail()
  2. 10 core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait::assertMenuActiveTrail()
  3. 11.x core/modules/system/tests/src/Functional/Menu/AssertMenuActiveTrailTrait.php \Drupal\Tests\system\Functional\Menu\AssertMenuActiveTrailTrait::assertMenuActiveTrail()

Assert that active trail exists in a menu tree output.

Parameters

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.

bool $last_active: Whether the last link in $tree is expected to be active (TRUE) or just to be in the active trail (FALSE).

1 call to AssertMenuActiveTrailTrait::assertMenuActiveTrail()
AssertBreadcrumbTrait::assertBreadcrumb in core/modules/system/src/Tests/Menu/AssertBreadcrumbTrait.php
Assert that a given path shows certain breadcrumb links.

File

core/modules/system/src/Tests/Menu/AssertMenuActiveTrailTrait.php, line 29

Class

AssertMenuActiveTrailTrait
Provides test assertions for verifying the active menu trail.

Namespace

Drupal\system\Tests\Menu

Code

protected function assertMenuActiveTrail($tree, $last_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)]/a[contains(@href, :href) and contains(text(), :title)]';
            $part_args = [
                ':class' => 'menu-item--active-trail',
                ':href' => Url::fromUri('base:' . $link_path)->toString(),
                ':title' => $link_title,
            ];
            $xpath .= $this->buildXPathQuery($part_xpath, $part_args);
            $i++;
        }
        $elements = $this->xpath($xpath);
        $this->assertTrue(!empty($elements), 'Active trail to current page was found 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' => 'menu-item--active-trail',
        ':class-active' => 'is-active',
        ':href' => Url::fromUri('base:' . $active_link_path)->toString(),
        ':title' => $active_link_title,
    ];
    $elements = $this->xpath($xpath, $args);
    $this->assertTrue(!empty($elements), new FormattableMarkup('Active link %title was found in menu tree, including active trail links %tree.', [
        '%title' => $active_link_title,
        '%tree' => implode(' » ', $tree),
    ]));
}

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