cjstroud/classnames-php

A simple PHP utility for conditionally joining classNames together

classnames-php

, _(*1)

PHP port of the JavaScript classNames utility. https://github.com/JedWatson/classnames, _(*2)

Installation

composer require cjstroud/classnames-php

The classNames can be accessed anywhere., _(*3)

classNames('foo', ['bar' => true]); // 'foo bar'

Usage

The classNames function takes any number of arguments which can be a string or array. When using an array, if the value associated with a given key is falsy, that key won't be included in the output. If no value is given the true is assumed., _(*4)

classNames('foo'); // 'foo'
classNames(['foo' => true]); // 'foo'
classNames('foo', ['bar' => false, 'baz' => true]); // 'foo baz'
classNames(['foo', 'bar' => true]) // 'foo bar'

// Falsy values get ignored
classNames('foo', null, 0, false, 1); // 'foo 1'

Objects and functions will be ignored, unless the object has __toString() function. If it does that will be called and the string value used., _(*5)

class ExampleObject {
    function __toString()
    {
        return 'bar';
    }
}

classNames('foo', function() {}, new stdClass(), new ExampleObject()); // 'foo bar'

Laravel Blade

License

MIT. Copyright (c) 2017 Chris Stroud., _(*6)