Download the PHP package epessine/vessel without Composer
On this page you can find all versions of the php package epessine/vessel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package vessel
Vessel - global state for Livewire
Vessel provides a global state for Livewire, allowing multiple components to share state without a multitude of events to handle interaction.
Just create a Vessel class, set it's properties and initialization and use it on your components.
Installation
No configuration needed.
Usage
Vessel works by creating 'vessel classes', where you define the properties that you global state will have:
You can also initialize your properties using the init()
method:
Then use the Vessel on your components with the Vessel\Attributes\Vessel
attribute. Take a look at the components below:
After calling Filter::selectUserFilter()
, the selectedUserType
will be updated on all components that use the same Vessel, and will reflect the change on the UserList::users
computed property query, for example.
All of that without a single event dispatch/listener!
Updated Hook
You can use the updated
lifecycle hook on Vessel properties the same way as Livewire properties. The updated method name should include the Vessel method name as well. Let's rewrite the example above:
This way, whenever the $selectedUserType
property on the FilterVessel
class is updated on any component that uses it, the updatedGlobalFiltersSelectedUserType
method will be called.
Troubleshooting
There are some base rules when using Vessel:
- Vessel properties cannot be accessed/mutated on the front-end via
$wire
. You can create methods that can be called on the front-end to interact with the Vessel indirectly, though.- Vessel properties are 'immutable' so any changes inside the property will not reflect on other components. Always reassign the property after making changes.
- Vessel uses the application cache to operate and maintain state, so storing huge amounts of data on a Vessel can slow down your whole application.