tautvydasr/blade-class-names

Package for handling html classes output based on conditions

Blade class names

, _(*1)

Simple package which helps to handle conditional html classes in blade templates., _(*2)

NOTICE: If Laravel 8 or later is used consider using native @class directive instead., _(*3)

Installation

First of all require this package in composer:, _(*4)

composer require tautvydasr/blade-class-names

Finally, add service provider to providers array in your config/app.php file for Laravel:, _(*5)

'providers' => [
    // ...
    ClassNames\ClassNamesServiceProvider::class,
    // ...
],

or register service provider in bootstrap/app.php if using Lumen:, _(*6)

...
$app->register(\ClassNames\ClassNamesServiceProvider::class);
...

Usage

Basically package allows you to simplify conditional classes situations like this, _(*7)

<a href="#" class="menu-item{{ $loop->first ? ' first-item' : '' }}{{ request()->routeIs('foo') ? ' active' : '' }}">
    ...
</a>

to this using blade directive @classNames()., _(*8)

<a href="#" class="@classNames('menu-item', ['first-item' => $loop->first, 'active' => request()->routeIs('foo')])">
    ...
</a>

For Lumen users it can be accessed via app() helper or facade., _(*9)

<a href="#" class="app('classnames')->render('menu-item', ['first-item' => $loop->first, 'active' => request()->routeIs('foo')])">
    ...
</a>

<a href="#" class="\ClassNames\ClassNamesFacade::render('menu-item', ['first-item' => $loop->first, 'active' => request()->routeIs('foo')])">
    ...
</a>

Using facade approach make sure the line $app->withFacades(); is uncommented in bootstrap/app.php file., _(*10)

Local setup

Copy example docker compose config file (optional):, _(*11)

cp docker-compose.yml.dist docker-compose.yml

Run docker containers (optional):, _(*12)

docker-compose up -d

Login to docker container where CONTAINER_ID is your id (optional):, _(*13)

docker exec -ti CONTAINER_ID /bin/bash

Install dependencies using composer:, _(*14)

composer install

Tests

Run phpunit tests:, _(*15)

./vendor/bin/phpunit

License

Package is free to use and is licensed under the MIT license, _(*16)