PHP Blade Directives
, (*1)
Custom Blade directives for Laravel Applications., (*2)
See https://laravel.com/docs/blade, (*3)
Laravel 5.x
Install the saritasa/blade-directives package:, (*4)
$ composer require saritasa/blade-directives
If you use Laravel 5.4 or less,
or 5.5+ with package discovery disabled,
add the BladeDirectivesServiceProvider service provider config/app.php:, (*5)
'providers' => array(
// ...
Saritasa\Laravel\BladeDirectivesServiceProvider::class,
)
Available directives
@activeIfRoute(routeName)
Output word 'active' if URL, requested by user, matches provided route name, (*6)
Example:, (*7)
<li class="@activeIfRoute('user.settings')">
<a href="{{ route('user.settings') }}">Settings</a>
</li>
@selectedIf(expression)
Output word 'selected' if passed expression evaluates to true, (*8)
Example:, (*9)
<select>
@foreach($users as $user)
<option value='{{ $user->id }}' @selectedIf($user->id == $currentUserId)>{{ $user->name }}</option>
@endforeach
</select>
Contributing
- Create fork, checkout it
- Develop locally as usual. Code must follow PSR-1, PSR-2 -
run PHP_CodeSniffer to ensure, that code follows style guides
- Update README.md to describe new or changed functionality
- Add changes description to CHANGES.md file. Use Semantic Versioning convention to determine next version number.
- When ready, create pull request
Make shortcuts
If you have GNU Make installed, you can use following shortcuts:, (*10)
-
make cs (instead of php vendor/bin/phpcs) -
run static code analysis with PHP_CodeSniffer
to check code style
-
make csfix (instead of php vendor/bin/phpcbf) -
fix code style violations with PHP_CodeSniffer
automatically, where possible (ex. PSR-2 code formatting violations)
-
make install - instead of composer install
-
make all or just make without parameters -
invokes described above install, cs tasks sequentially -
project will be assembled and checked with linter with one single command
Resources