wire:stream:
Livewire allows you to stream content to a web page before a request is complete via the wire:stream API.
It is is a Livewire directive used for real-time streaming of data from the backend to the frontend. It's particularly useful for scenarios where you want to display live updates without the need for page refreshes.
wire:ignore
wire:ignore directive to instruct Livewire to ignore the contents of a particular element, even if they change between requests.
This is most useful in the context of working with third-party javascript libraries for custom form inputs and suchas date picker
wire:offline
you may want to notify your users in some way if they are offline so that they don't draft an entire blog post without the ability for Livewire to save it to the database.
wire:init
directive to run an action as soon as the component is rendered. This can be helpful in cases where you don't want to hold up the entire page load, but want to load some data immediately after the page load.
wire-transition
Showing or hiding content in Livewire is as simple as using one of Blade's conditional directives like @if. To enhance this experience for your users, Livewire provides a wire:transition directive that allows you to transition conditional elements smoothly in and out of the page.to toggle viewing comments on and off
wire:confirm
Before performing dangerous actions in Livewire, you may want to provide your users with some sort of visual confirmation.
When a user clicks "Delete post", Livewire will trigger a confirmation dialog (The default browser confirmation alert). If the user hits escape or presses cancel, the action won't be performed. If they press "OK", the action will be completed
wire:dirty
By adding wire:dirty to an element, you are instructing Livewire to only show the element when the client-side state diverges from the server-side state.
You can validate form inputs in real-time or even save the form as a user types.
In these "real-time" update scenarios, it can be helpful to signal to your users when a form or subset of a form has been changed, but hasn't been saved to the database.
When a form contains un-saved input, that form is considered "dirty
wire:navigate
Livewire will intercept the click and instead of allowing the browser to perform a full page visit, Livewire will fetch the page in the background and swap it with the current page
wire:poll
Polling is a technique used in web applications to "poll" the server (send requests on a regular interval) for updates. like subscriber count
Example of wire:stream
wire:stream is a Livewire directive used for real-time streaming of data from the backend to the frontend. It's particularly useful for scenarios where you want to display live updates without the need for page refreshes.
Here's a simple example to illustrate how wire:stream works:
Set Up Livewire Component:
First, let's create a Livewire component that generates random numbers and streams them to the frontend.
Run the following Artisan command to create a new Livewire component:
php artisan make:livewire NumberStreamer
This command will create a new Livewire component named NumberStreamer.
Define Properties and Methods:
Open the app/Http/Livewire/NumberStreamer.php file and define properties and methods as follows:
// app/Http/Livewire/NumberStreamer.php
namespace App\Http\Livewire;
use Livewire\Component;
class NumberStreamer extends Component
{
public $number;
public function generateNumber()
{
$this->number = rand(1, 100);
}
public function mount()
{
$this->generateNumber();
}
public function render()
{
return view('livewire.number-streamer');
}
}
In this component, we have a property $number to store the generated random number. The generateNumber method generates a random number and assigns it to $number. We call generateNumber in the mount method to initialize $number when the component is mounted.
Create Livewire Blade View:
Create a Blade view file named number-streamer.blade.php in the resources/views/livewire directory:
<!-- resources/views/livewire/number-streamer.blade.php -->
<div>
<h1>Random Number Streamer</h1>
<h2>Current Number: {{ $number }}</h2>
<button wire:click="generateNumber">Generate New Number</button>
</div>
This view displays the current random number and a button to generate a new one.
Add wire:stream Directive:
Update the number-streamer.blade.php file to include the wire:stream directive:
<!-- resources/views/livewire/number-streamer.blade.php -->
<div>
<h1>Random Number Streamer</h1>
<h2>Current Number: <span wire:stream="generateNumber">{{ $number }}</span></h2>
</div>
With wire:stream, Livewire automatically updates the content of the element with the result of the generateNumber method. This allows for real-time streaming of data without the need for page reloads.
Include Livewire Component in a Blade View:
Now, include the NumberStreamer Livewire component in any Blade view where you want to display the random number stream:
<!-- resources/views/welcome.blade.php -->
@livewire('number-streamer')
Run the Application:
Finally, run your Laravel application:
php artisan serve
Visit the specified URL in your browser, and you should see the Livewire component displaying the current random number. Each time you click the "Generate New Number" button, Livewire will automatically update the displayed number without refreshing the page, thanks to the wire:stream directive.
Example with wire:init
Define the Livewire Component:
In the DashboardStats component, we'll use the wire:init directive to execute the initialize method when the component is first rendered. Inside this method, we'll fetch data from the database and initialize the component properties.
// app/Http/Livewire/DashboardStats.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User;
use App\Models\Sale;
use App\Models\Activity;
class DashboardStats extends Component
{
public $userCount;
public $totalSales;
public $recentActivity;
public function initialize()
{
// Fetch data from the database
$this->userCount = User::count();
$this->totalSales = Sale::sum('amount');
$this->recentActivity = Activity::latest()->take(5)->get();
}
public function render()
{
return view('livewire.dashboard-stats');
}
}
Include the wire:init Directive in the Blade View:
Update the Blade view file to include the wire:init directive:
<!-- resources/views/livewire/dashboard-stats.blade.php -->
<div>
<h2>User Statistics</h2>
<p>Total Users: {{ $userCount }}</p>
<p>Total Sales: {{ $totalSales }}</p>
<h2>Recent Activity</h2>
<ul>
@foreach ($recentActivity as $activity)
<li>{{ $activity->description }}</li>
@endforeach
</ul>
</div>
Include the Livewire Component in a Blade View:
Include the DashboardStats Livewire component in your dashboard view with the wire:init directive:
<!-- resources/views/dashboard.blade.php -->
@livewire('dashboard-stats')
Include the wire:init directive to call the initialize method when the component is initialized:
@livewire('dashboard-stats')
@livewireScripts
<script>
document.addEventListener('livewire:load', function () {
Livewire.emit('initialize');
});
</script>
Run the Application:
Finally, run your Laravel application:
php artisan serve
Now, when you navigate to the dashboard page, the DashboardStats Livewire component will be initialized, and the initialize method will be executed due to the wire:init directive. This method fetches data from the database and initializes the component properties. The dashboard will then display the user statistics and recent activity fetched from the database.
Another Example
let's create an example demonstrating the usage of wire:ignore and wire:init in Laravel Livewire with server-side database updates. In this example, we'll create a simple form to update a user's profile information.
Set Up the Laravel Project:
First, create a new Laravel project using Composer:
composer create-project --prefer-dist laravel/laravel livewire-example
Install Livewire:
Install Livewire via Composer:
composer require livewire/livewire
Create a Livewire Component:
Run the following Artisan command to generate a Livewire component:
php artisan make:livewire UserProfile
Define the Livewire Component:
Open the app/Http/Livewire/UserProfile.php file and define the Livewire component's logic:
// app/Http/Livewire/UserProfile.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class UserProfile extends Component
{
public $user;
public $name;
public $email;
public function mount($userId)
{
$this->user = User::find($userId);
$this->name = $this->user->name;
$this->email = $this->user->email;
}
public function updateUser()
{
$this->user->update([
'name' => $this->name,
'email' => $this->email,
]);
session()->flash('message', 'Profile updated successfully!');
}
public function render()
{
return view('livewire.user-profile');
}
}
Create a Blade View for the Component:
Create a Blade view file named user-profile.blade.php in the resources/views/livewire directory:
<!-- resources/views/livewire/user-profile.blade.php -->
<div wire:init="initialize" wire:ignore>
<h1>User Profile</h1>
<form wire:submit.prevent="updateUser">
<div>
<label for="name">Name:</label>
<input type="text" id="name" wire:model.defer="name">
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" wire:model.defer="email">
</div>
<button type="submit">Update</button>
</form>
</div>
In this example, we're using wire:ignore to tell Livewire to ignore the entire
element, preventing Livewire from syncing it with the backend. We'll manually initialize the input fields with the user's data using wire:init.Define the Initialization Method:
Update the UserProfile component class (UserProfile.php) to include the initialize method:
// app/Http/Livewire/UserProfile.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class UserProfile extends Component
{
public $user;
public $name;
public $email;
public function mount($userId)
{
$this->user = User::find($userId);
}
public function updateUser()
{
$this->user->update([
'name' => $this->name,
'email' => $this->email,
]);
session()->flash('message', 'Profile updated successfully!');
}
public function initialize()
{
$this->name = $this->user->name;
$this->email = $this->user->email;
}
public function render()
{
return view('livewire.user-profile');
}
}
Include the Livewire Component in a Blade View:
Include the UserProfile Livewire component in any Blade view where you want to display the user profile form:
<!-- resources/views/welcome.blade.php -->
@livewire('user-profile', ['userId' => $userId])
Replace $userId with the actual user ID.
Run the Application:
Finally, run your Laravel application:
php artisan serve
Visit the specified URL in your browser, and you should see the Livewire component displaying the user profile form. The form will be pre-filled with the user's data, and you can update the profile information. When you submit the form, the user's profile will be updated in the database, and a success message will be displayed. Livewire will ignore the
element containing the form during updates.Example of wire:init
Let's create a step-by-step example to demonstrate the usage of wire:init in Laravel Livewire with server-side database updates. In this example, we'll create a simple form to update a user's profile information, and we'll initialize the form fields with the user's data retrieved from the database.
Set Up the Laravel Project:
First, create a new Laravel project using Composer:
composer create-project --prefer-dist laravel/laravel livewire-example
Install Livewire:
Install Livewire via Composer:
composer require livewire/livewire
Create a Livewire Component:
Run the following Artisan command to generate a Livewire component:
php artisan make:livewire UserProfile
Define the Livewire Component:
Open the app/Http/Livewire/UserProfile.php file and define the
// app/Http/Livewire/UserProfile.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class UserProfile extends Component
{
public $user;
public $name;
public $email;
public function mount($userId)
{
$this->user = User::findOrFail($userId);
}
public function updateUser()
{
$validatedData = $this->validate([
'name' => 'required|string|max:255',
'email' => 'required|email|unique:users,email,' . $this->user->id,
]);
$this->user->update($validatedData);
session()->flash('message', 'Profile updated successfully!');
}
public function render()
{
return view('livewire.user-profile');
}
}
Create a Blade View for the Component:
Create a Blade view file named user-profile.blade.php in the resources/views/livewire directory:
<!-- resources/views/livewire/user-profile.blade.php -->
<div>
<h1>User Profile</h1>
<form wire:submit.prevent="updateUser">
<div>
<label for="name">Name:</label>
<input type="text" id="name" wire:model.defer="name">
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" wire:model.defer="email">
</div>
<button type="submit">Update</button>
</form>
</div>
Initialize Form Fields with User Data Using wire:init:
Update the user-profile.blade.php file to include the wire:init directive:
<!-- resources/views/livewire/user-profile.blade.php -->
<div wire:init="initialize">
<h1>User Profile</h1>
<form wire:submit.prevent="updateUser">
<div>
<label for="name">Name:</label>
<input type="text" id="name" wire:model.defer="name">
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" wire:model.defer="email">
</div>
<button type="submit">Update</button>
</form>
</div>
In this example, we're using wire:init="initialize" to call the initialize method when the component is first loaded. This method will initialize the form fields with the user's data.
Define the Initialization Method:
Update the UserProfile component class (UserProfile.php) to include the initialize method:
// app/Http/Livewire/UserProfile.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class UserProfile extends Component
{
public $user;
public $name;
public $email;
public function mount($userId)
{
$this->user = User::findOrFail($userId);
}
public function updateUser()
{
$validatedData = $this->validate([
'name' => 'required|string|max:255',
'email' => 'required|email|unique:users,email,' . $this->user->id,
]);
$this->user->update($validatedData);
session()->flash('message', 'Profile updated successfully!');
}
public function initialize()
{
$this->name = $this->user->name;
$this->email = $this->user->email;
}
public function render()
{
return view('livewire.user-profile');
}
}
Include the Livewire Component in a Blade View:
Include the UserProfile Livewire component in any Blade view where you want to display the user profile form:
<!-- resources/views/welcome.blade.php -->
@livewire('user-profile', ['userId' => $userId])
Replace $userId with the actual user ID.
Run the Application:
Finally, run your Laravel application:
php artisan serve
Visit the specified URL in your browser, and you should see the Livewire component displaying the user profile form. The form fields will be pre-filled with the user's data retrieved from the database. You can update the profile information, and when you submit the form, the user's profile will be updated in the database, and a success message will be displayed.
Explain the use of wire:transition using example
Let's create a step-by-step example to demonstrate the usage of the wire:transition directive in Laravel Livewire to show or hide content with server-side database updates.
In this example, we'll create a simple toggle button that allows users to show or hide some content. We'll use Livewire to update the database whenever the user toggles the button, and we'll use wire:transition to add smooth transitions to the content.
Set Up the Laravel Project:
First, create a new Laravel project using Composer:
composer create-project --prefer-dist laravel/laravel livewire-example
Install Livewire:
Install Livewire via Composer:
composer require livewire/livewire
Create a Livewire Component:
Run the following Artisan command to generate a Livewire component:
php artisan make:livewire ContentToggle
Define the Livewire Component:
Open the app/Http/Livewire/ContentToggle.php file and define the Livewire component's logic:
// app/Http/Livewire/ContentToggle.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class ContentToggle extends Component
{
public $showContent = false;
public function toggleContent()
{
$this->showContent = !$this->showContent;
// Update the database to reflect the new state
$user = User::find(auth()->id());
$user->update(['show_content' => $this->showContent]);
}
public function render()
{
return view('livewire.content-toggle');
}
}
Create a Blade View for the Component:
Create a Blade view file named content-toggle.blade.php in the resources/views/livewire directory:
<!-- resources/views/livewire/content-toggle.blade.php -->
<div>
<button wire:click="toggleContent">Toggle Content</button>
<div wire:transition.fade>
@if ($showContent)
<p>This is the hidden content that will be toggled.</p>
@endif
</div>
</div>
In this example, we're using wire:transition.fade to add a fade transition effect to the content when it appears or disappears.
Include the Livewire Component in a Blade View:
Include the ContentToggle Livewire component in any Blade view where you want to display the toggle button and content:
<!-- resources/views/welcome.blade.php -->
@livewire('content-toggle')
Run the Application:
Finally, run your Laravel application:
php artisan serve
Visit the specified URL in your browser, and you should see the Livewire component displaying the toggle button. When you click the button, the hidden content will smoothly appear or disappear with a fade transition effect. Additionally, the component will update the database to reflect the new state whenever the button is toggled.
Explain the use Wire:dirty directive
The wire:dirty directive in Laravel Livewire is used to check if a Livewire component property has been modified since it was last loaded or saved. This can be useful for various scenarios, such as conditionally displaying a confirmation message before leaving a page if there are unsaved changes.
Let's create a step-by-step example to demonstrate the usage of wire:dirty in Laravel Livewire with server-side database updates:
Set Up the Laravel Project:
First, create a new Laravel project using Composer:
composer create-project --prefer-dist laravel/laravel livewire-example
Install Livewire:
Install Livewire via Composer:
composer require livewire/livewire
Create a Livewire Component:
Run the following Artisan command to generate a Livewire component:
php artisan make:livewire UserProfile
Define the Livewire Component:
Open the app/Http/Livewire/UserProfile.php file and define the Livewire component's logic:
// app/Http/Livewire/UserProfile.php
namespace App\Http\Livewire;
use Livewire\Component;
use App\Models\User; // Assuming you have a User model
class UserProfile extends Component
{
public $user;
public $name;
public $email;
public $isDirty = false;
public function mount($userId)
{
$this->user = User::findOrFail($userId);
$this->name = $this->user->name;
$this->email = $this->user->email;
}
public function updated($propertyName)
{
// Set isDirty to true if any property is updated
$this->isDirty = true;
}
public function updateUser()
{
$validatedData = $this->validate([
'name' => 'required|string|max:255',
'email' => 'required|email|unique:users,email,' . $this->user->id,
]);
$this->user->update($validatedData);
// Reset isDirty to false after updating
$this->isDirty = false;
session()->flash('message', 'Profile updated successfully!');
}
public function render()
{
return view('livewire.user-profile');
}
}
Create a Blade View for the Component:
Create a Blade view file named user-profile.blade.php in the resources/views/livewire directory:
<!-- resources/views/livewire/user-profile.blade.php -->
<div>
<h1>User Profile</h1>
<form wire:submit.prevent="updateUser">
<div>
<label for="name">Name:</label>
<input type="text" id="name" wire:model="name">
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" wire:model="email">
</div>
@if($isDirty)
<p>Your changes are not saved.</p>
@endif
<button type="submit">Update</button>
</form>
</div>
In this example, we're displaying a message if $isDirty is true, indicating that there are unsaved changes.
Include the Livewire Component in a Blade View:
Include the UserProfile Livewire component in any Blade view where you want to display the user profile form:
<!-- resources/views/welcome.blade.php -->
@livewire('user-profile', ['userId' => $userId])
Replace $userId with the actual user ID.
Run the Application:
Finally, run your Laravel application:
php artisan serve
Visit the specified URL in your browser, and you should see the Livewire component displaying the user profile form. Any changes made to the form fields will set $isDirty to true, displaying a message indicating that the changes are not saved. After submitting the form, $isDirty will be reset to false.
Top comments (0)