spatie / laravel-blade-x
Supercharged Blade components
Installs: 188 777
Dependents: 6
Suggesters: 1
Security: 0
Stars: 526
Watchers: 9
Forks: 39
Open Issues: 0
Requires
- php: ^7.2
- illuminate/view: ~5.8.0|^6.0
Requires (Dev)
- orchestra/testbench: ~3.8.0|^4.0
- phpunit/phpunit: ^8.0
- spatie/phpunit-snapshot-assertions: ^2.1
README
We have abandoned this package because Laravel 7 introduced native support for Blade-X style components.
Only use this package if you're on Laravel 6 or below.
When upgrading to Laravel 7 you should convert your Blade X components to native Laravel Blade components
Supercharged Blade components
This package provides an easy way to render custom HTML components in your Blade views.
Here's an example. Instead of this
<h1>My view</h1> @include('myAlert', ['type' => 'error', 'message' => $message])
you can write this:
<h1>My view</h1> <my-alert type="error" :message="$message" />
You can place the content of that alert in a simple Blade view that needs to be registered before using the my-alert
component.
{{-- resources/views/components/myAlert.blade.php --}} <div class="{{ $type }}"> {{ $message }} </div>
Installation
You can install the package via Composer:
composer require spatie/laravel-blade-x
The package will automatically register itself.
Documentation
You'll find the documentation on https://docs.spatie.be/laravel-blade-x/v2/introduction.
Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the media library? Feel free to create an issue on GitHub, we'll try to address it as soon as possible.
If you've found a bug regarding security please mail freek@spatie.be instead of using the issue tracker.
Upgrading major versions
Please see UPGRADING for more information on how to upgrade from one major version to the other.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
- Brent Roose
- Alex Vanderbist
- Ruben Van Assche
- Sebastian De Deyne
- Freek Van der Herten
- All Contributors
Support us
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
License
The MIT License (MIT). Please see License File for more information.