You're browsing the documentation for an old version of Livewire. Consider upgrading your project to Livewire 3.x.

If you've used front-end frameworks like Angular, React, or Vue, you are already familiar with this concept. However, if you are new to this concept, allow me to demonstrate.

            
1use Livewire\Component;
2 
3class MyNameIs extends Component
4{
5 public $name;
6 
7 public function render()
8 {
9 return view('livewire.my-name-is');
10 }
11}
            
1<div>
2 <input type="text" wire:model="name">
3 
4 Hi! My name is {{ $name }}
5</div>

When the user types something into the text field, the value of the $name property will automatically update. Livewire knows to keep track of the provided name because of the wire:model directive.

Internally, Livewire listens for "input" events on the element and updates the class property with the element's value. Therefore, you can apply wire:model to any element that emits input events.

By default, Livewire applies a 150ms debounce to text inputs. You can override this default like so: <input type="text" wire:model.debounce.0ms="name">

Common elements to use wire:model on include:

Element Tag
<input type="text">
<input type="radio">
<input type="checkbox">
<select>
<textarea>

Nested Data Binding

Livewire supports nested data binding using dot notation:

        
1<input type="text" wire:model="form.name">

Debouncing Input

Livewire offers a "debounce" modifier when using wire:model. If you want to apply a 1 second debounce to an input, you include the modifier like so:

        
1<input type="text" wire:model.debounce.1000ms="name">
2 
3<!-- You can also specify the time in seconds: -->
4<input type="text" wire:model.debounce.1s="name">

Lazily Updating

By default, Livewire sends a request to server after every "input" event. This is usually fine for things like <select> elements that don't update frequently, however, this is often unnecessary for text fields that update as the user types.

In those cases, use the lazy directive modifier to listen for the native "change" event.

            
1use Livewire\Component;
2 
3class MyNameIs extends Component
4{
5 public $name;
6 
7 public function render()
8 {
9 return view('livewire.my-name-is');
10 }
11}
            
1<div>
2 <input type="text" wire:model.lazy="name">
3 
4 My name is chica-chica {{ $name }}
5</div>

Now, the $name property will only be updated when the user clicks away from the input field.

Next Topic → Installation