X-livewire

This package allows you to render livewire components like a blade component, giving it attributes, slots etc.

Assuming you wanted to create a livewire component, alert, usually you would render the component by: . However, there a few problems.

1. You can't allow slots within the component. That is, this is invalid: Alert.
2. You can't access the $attributes bag. Thus, can't access the $attributes variable directly. That is, if you do this: , you can't access the $title attribute by $attributes->get('title'). Instead, you'd have to make $title a public property in the component. Not to mention, other methods on $attributes are not accessible. Such as ->merge([]), ->whereStartsWith(), etc.

The creator of livewire, Caleb Porzio has made it clear that adding slots, attributes etc are not currently on the roadmap.

That's why I created X-livewire.

With X-Livewire, you can do:

    
        My alert message
    

And, just like with Blade, you can:

1. Access the $attributes variable: {{ $attributes->get('title') }},
2. Access the $slot variable: {{ $slot }}

Installation

You can install the package via composer:

composer require titonova/x-livewire

Usage

1. After creating your livewire component, make it extend XLivewireBaseComponent rather than Component. ie: class Alert extends XLivewireBaseComponent{
2. In the view file of the component, e.g alert.blade.php add @setUpXLivewire to the top of the file.
3. When you want to render the component: Blade My alert message
4. You can access the $slot and $attributes variables just like you would in a Blade component:

   {{ $slot }}
   {{ $attributes->get('title') }}
   

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

TODO/Roadmap

[ ] Add Tests [ ] Shorten tag declartion to

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Tito Amoo
• All Contributors

License

The MIT License (MIT). Please see License File for more information.