ActiveMenuItemBundle

The active menu item highlight of simple HTML menu for Symfony framework

How to install

Install it with Composer first:

composer require bw/active-menu-item-bundle

Then, to use filters and functions in Twig, register this bundle in bundles.php:

// config/bundles.php

return [
    // other bundles...
    BW\ActiveMenuItemBundle\BWActiveMenuItemBundle::class => ['all' => true],
};

How to use

To check whether menu item route is active, simply use is_active Twig filter:

{{ path('route_name')|is_active }}

or use is_active_uri Twig filter for check whether menu item request URI is active:

{{ 'route_name'|is_active_uri }}

If route or request URI is match, filters return current active string.

How to use with multilevel menu

To check array of possible routes use is_active() Twig function, passed array of routes (all submenu item routes of current item) as a first parameter and the current item route as a second parameter.

For example, there are simple HTML menu with submenu:

<ul>
    <li class="{{ is_active([
        'subcategory1',
        'subcategory2',
    ], 'all_categories') }}">
        <a href="{{ path('all_categories') }}">All categories</a>
        <ul>
            <li class="{{ 'subcategory1'|is_active }}">
                <a href="{{ path('subcategory1') }}">Subcategory 1</a>
            </li>
            <li class="{{ 'subcategory2'|is_active }}">
                <a href="{{ path('subcategory2') }}">Subcategory 2</a>
            </li>
        </ul>
    </li>
</ul>

If the current route is subcategory1, it has current active class and its parent item with all_categories route has only active class.

And same for request URIs with is_active_uri() Twig function.

Demo page

Bundle has demo page with example of simple multilevel HTML menu.

# config/routes/dev/bw_active_menu.yaml

bw_active_menu_item:
    resource: "@BWActiveMenuItemBundle/Resources/config/routing.yml"
    prefix:   /bw/demo/active-menu-item

Run built in server php bin/console server:run and demo page will be available at http://localhost:8000/bw/demo/active-menu-item/index.

Under the hood

There are only a few additional simple Twig filters and functions for use.