lucadello91/laravel-active

Laravel helper for detecting active navigation menu items and applying bootstrap classes.

Laravel-Active

, _(*1)

Laravel helper that detects active navigation menu items and applies bootstrap classes. This is an implementation of https://github.com/laravelista/Ekko. In this implementation, you can use it with resouce name too., _(*2)

Installation

First, pull in the package through Composer., _(*3)

"require": {
    "lucadello91/laravel-active": "^2.0"
}

And then, if using Laravel 5 or 4, include the service provider within app/config/app.php., _(*4)

'providers' => [
    Lucadello91\Active\LaravelActiveServiceProvider::class
];

And, for convenience, add a facade alias to this same file at the bottom:, _(*5)

'aliases' => [
    'Active'    => Lucadello91\Active\Facades\LaravelActive::class
];

Usage

You would most likely use this package in your navbar partial like so:, _(*6)

<li>
    <a href="{{ route('home') }}" class="{{ Active::isActiveRoute('home') }}">
        <i class="halflings white home"></i> Home
    </a>
</li>

<li>
    <a href="#" class="{{ Active::areActiveRoutes(['murter', 'kornati']) }}">
        <i class="halflings white screenshot"></i> Location
    </a>
    <ul>
        <li>
            <a href="{{ route('murter') }}">Murter</a>
        </li>
        <li>
            <a href="{{ route('kornati') }}">Kornati</a>
        </li>
    </ul>
</li>

<li>
    <a href="{{ route('trips.index') }}" class="{{ Active::isActiveMatch('trips') }}">
        <i class="halflings white road"></i> Trips
    </a>
</li>

API

As the second parameter to any method, you can pass the value you want to get returned if there was a match. By default this is active which is Bootstrap default., _(*7)

As the third parameter to any method, you can pass the value you want to get returned if there wasn't a match. By default this is empty string., _(*8)

isActiveRoute($routeName, $active = "active", $notActive = "")

Compares given route name with current route name., _(*9)

{{ Active::isActiveRoute('home') }}

isActiveRouteResourceName($resourceName, $active = "active", $notActive = "")

Compares given resource name with current Route::Resource name., _(*10)

{{ Active::isActiveRouteResourceName('home') }}

isActiveURL($url, $active = "active", $notActive = "")

Compares given URL with current URL., _(*11)

{{ Active::isActiveURL('/about') }}

isActiveMatch($string, $active = "active", $notActive = "")

Detects if the given string is found in the current URL., _(*12)

{{ Active::isActiveMatch('bout') }}

areActiveRoutes(array $routeNames, $active = "active", $notActive = "")

Compares given array of route names with current route name., _(*13)

{{ Active::areActiveRoutes(['product.index', 'product.show']) }}

areActiveRoutesResourcesNames(array $resourcesNames, $active = "active", $notActive = "")

Compares given array of resource names with current Route::Resource name., _(*14)

{{ Active::areActiveRoutesResourcesNames(['post', 'comments']) }}

areActiveURLs(array $urls, $active = "active", $notActive = "")

Compares given array of URLs with current URL., _(*15)

{{ Active::areActiveURLs(['/product', '/product/create']) }}