rendering-components.blade.php

* [Inline Components](#inline-components)
  * [Parameters](#parameters)
* [Full-Page Components](#page-components)
  * [Configuring The Layout Component](#custom-layout)
  * [Route Parameters](#route-params)
  * [Route Model Binding](#route-model-binding)
* [The Render Method](#render-method)
  * [Returning Blade Views](#returning-blade)
  * [Returning Template String](#returning-strings)

## Inline Components {#inline-components}

The most basic way to render a Livewire component on a page is using the `<livewire:` tag syntax:

@component('components.code', ['lang' => 'blade'])
@verbatim
<div>
    <livewire:show-posts />
</div>
@endverbatim
@endcomponent

Alternatively you can use the `@@livewire` blade directive:

@component('components.code', ['lang' => 'blade'])
@verbatim
    @livewire('show-posts')
@endverbatim
@endcomponent

If you have a component inside of a sub-folder with its own namespace, you must use a dot (`.`) prefixed with the namespace.

For example, if we have a `ShowPosts` component inside of a `app/Http/Livewire/Nav` folder, we would indicate it as such:

@component('components.code', ['lang' => 'blade'])
@verbatim
<livewire:nav.show-posts />
@endverbatim
@endcomponent

### Parameters {#parameters}

#### Passing Parameters

You can pass data into a component by passing additional parameters into the <code><livewire:</code> tag.

For example, let's say we have a `show-post` component. Here's how you would pass in a `$post` model.

@component('components.code', ['lang' => 'blade'])
@verbatim
<livewire:show-post :post="$post">
@endverbatim
@endcomponent

Alternatively, this is how you can pass in parameters using the Blade directive.

@component('components.code', ['lang' => 'blade'])
@verbatim
@livewire('show-post', ['post' => $post])
@endverbatim
@endcomponent

#### Receiving Parameters

Livewire will automatically assign parameters to matching public properties.

For example, in the case of @verbatim `<livewire:show-post :post="$post">` @endverbatim, if the `show-post` component has a public property named `$post`, it will be automatically assigned:

@component('components.code', ['lang' => 'php'])
@verbatim
class ShowPost extends Component
{
    public $post;

    ...
}
@endverbatim
@endcomponent

If for whatever reason, this automatic behavior doesn't work well for you, you can intercept parameters using the `mount()` method:

@component('components.code', ['lang' => 'php'])
@verbatim
class ShowPost extends Component
{
    public $title;
    public $content;

    public function mount($post)
    {
        $this->title = $post->title;
        $this->content = $post->content;
    }

    ...
}
@endverbatim
@endcomponent

@component('components.tip')
In Livewire components, you use <code>mount()</code> instead of a class constructor <code>__construct()</code> like you may be used to.

NB: <code>mount()</code> is only ever called when the component is first mounted and will not be called again even when the component is refreshed or rerendered.
@endcomponent


Like a controller, you can inject dependencies by adding type-hinted parameters before passed-in ones.

@component('components.code', ['lang' => 'php'])
@verbatim
use \Illuminate\Session\SessionManager;

class ShowPost extends Component
{
    public $title;
    public $content;

    public function mount(SessionManager $session, $post)
    {
        $session->put("post.{$post->id}.last_viewed", now());

        $this->title = $post->title;
        $this->content = $post->content;
    }

    ...
}
@endverbatim
@endcomponent

## Full-Page Components {#page-components}

If the main content of a page is a Livewire component, you can pass the component directly into a Laravel route as if it were a controller.

@component('components.code', ['lang' => 'php'])
@verbatim
Route::get('/post', ShowPosts::class);
@endverbatim
@endcomponent

By default, Livewire will render the `ShowPosts` component into the `@{{ $slot }}` of a blade layout component located at: `resources/views/layouts/app.blade.php`

@component('components.code-component')
@slot('view')
@verbatim
<head>
    @livewireStyles
</head>
<body>
    {{ $slot }}

    @livewireScripts
</body>
@endverbatim
@endslot
@endcomponent

For more information on Laravel components, [visit Laravel's documentation](https://laravel.com/docs/blade#components).

### Configuring The Layout Component {#custom-layout}

If you want to specify a default layout other than the `layouts.app`, you can override the `livewire.layout` config option.
@component('components.code', ['lang' => 'php'])
    'layout' => 'app.other_default_layout'
@endcomponent

If you need even more control, you can use the `->layout()` method on the view instance you return from `render()`.
@component('components.code', ['lang' => 'php'])
@verbatim
class ShowPosts extends Component
{
    ...
    public function render()
    {
        return view('livewire.show-posts')
            ->layout('layouts.base');
    }
}
@endverbatim
@endcomponent

If your layout has an associated class file, you will need to reference that for any custom logic or properties.
@component('components.code', ['lang' => 'php'])
@verbatim
class ShowPosts extends Component
{
    ...
    public function render()
    {
        return view('livewire.show-posts')
            ->layout(\App\View\Components\BaseLayout::class);
    }
}
@endverbatim
@endcomponent

If you are using a non-default slot in the component, you can also chain on `->slot()`:

@component('components.code', ['lang' => 'php'])
public function render()
{
    return view('livewire.show-posts')
        ->layout('layouts.base')
        ->slot('main');
}
@endcomponent

Alternatively, Livewire supports using traditional Blade layout files with `@@extends`.

Given the following layout file:

@component('components.code')
@verbatim
<head>
    @livewireStyles
</head>
<body>
    @yield('content')

    @livewireScripts
</body>
@endverbatim
@endcomponent

You can configure Livewire to reference it using `->extends()` instead of `->layout()`:

@component('components.code', ['lang' => 'php'])
public function render()
{
    return view('livewire.show-posts')
        ->extends('layouts.app');
}
@endcomponent

If you need to configure the `@@section` for the component to use, you can configure that as well with the `->section()` method:

@component('components.code', ['lang' => 'php'])
public function render()
{
    return view('livewire.show-posts')
        ->extends('layouts.app')
        ->section('body');
}
@endcomponent

If you need to pass data from your components to your layout, you can pass the data along with the layout method:

@component('components.code', ['lang' => 'php'])
public function render()
{
    return view('livewire.show-posts')
        ->layout('layouts.base', ['title' => 'Show Posts'])
}
@endcomponent

In some cases you don't need to pass your layout name or you want to pass layout data separately, you can use layoutData method:

@component('components.code', ['lang' => 'php'])
public function render()
{
    return view('livewire.show-posts')
        ->layoutData(['title' => 'Show Posts'])
}
@endcomponent

### Route Parameters {#route-params}

Often you need to access route parameters inside your controller methods. Because we are no longer using controllers, Livewire attempts to mimic this behavior through its `mount` method. For example:

@component('components.code', ['lang' => 'php'])
Route::get('/post/{id}', ShowPost::class);
@endcomponent

@component('components.code', ['lang' => 'php'])
class ShowPost extends Component
{
    public $post;

    public function mount($id)
    {
        $this->post = Post::find($id);
    }

    ...
}
@endcomponent

As you can see, the `mount` method in a Livewire component is acting like a controller method would as far as its parameters go. If you visit `/post/123`, the `$id` variable passed into the `mount` method will contain the value `123`.

### Route Model Binding {#route-model-binding}

Like you would expect, Livewire components implement all functionality you're used to in your controllers including route model binding. For example:

@component('components.code', ['lang' => 'php'])
Route::get('/post/{post}', ShowPost::class);
@endcomponent

@component('components.code', ['lang' => 'php'])
class ShowPost extends Component
{
    public $post;

    public function mount(Post $post)
    {
        $this->post = $post;
    }
}
@endcomponent

If you are using PHP 7.4, you can also typehint class properties, and Livewire will automatically route-model bind to them. The following component's `$post` property will be automatically injected with no need for the `mount()` method.

@component('components.code', ['lang' => 'php'])
class ShowPost extends Component
{
    public Post $post;
}
@endcomponent

## The Render Method {#render-method}

A Livewire component's `render` method gets called on the initial page load AND every subsequent component update.

@component('components.tip')
In simple components, you don't need to define a `render` method yourself. The base Livewire component class has a dynamic `render` method included.
@endcomponent

### Returning Blade Views {#returning-blade}
The `render()` method is expected to return a Blade view, therefore, you can compare it to writing a controller method. Here is an example:

@component('components.warning')
Make sure your Blade view only has ONE root element.
@endcomponent

@component('components.code-component')
@slot('class')
@verbatim

class ShowPosts extends Component
{
    public function render()
    {
        return view('livewire.show-posts', [
            'posts' => Post::all(),
        ]);
    }
}
@endverbatim
@endslot
@slot('view')
@verbatim
<div>
    @foreach ($posts as $post)
        @include('includes.post', $post)
    @endforeach
</div>
@endverbatim
@endslot
@endcomponent

### Returning Template Strings {#returning-strings}
In addition to Blade views, you can optionally return a Blade template string from `render()`.

@component('components.code-component')
@slot('class')
@verbatim
class DeletePost extends Component
{
    public Post $post;

    public function delete()
    {
        $this->post->delete();
    }

    public function render()
    {
        return <<<'blade'
            <div>
                <button wire:click="delete">Delete Post</button>
            </div>
        blade;
    }
}
@endverbatim
@endslot
@endcomponent

@component('components.tip')
For inline components like above, you should use the <code>--inline</code> flag during creation: <code>artisan make:livewire delete-post --inline</code>
@endcomponent