Use custom HTML components in your Blade views
Clone or download
Latest commit 7256bf0 Oct 11, 2018

README.md

Supercharged Blade components

Latest Version on Packagist Build Status Quality Score StyleCI Total Downloads

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.

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

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.