Revision: Thu, 26 Sep 2024 15:47:52 GMT
v2.14 – outdated
This version of the documentation is outdated. Consider upgrading your project to Spiral Framework 3.14
Edit this page

Views - Rendering Views

To render view, you must obtain an instance of Spiral\Views\ViewsInterface.

Note
The component is available via prototyped property views.

Rendering

To render view in the controller or other service simply invoke the render method of ViewsInterface. The view name does not need to include extension or namespace (default to be used).

php
use Spiral\Views\ViewsInterface;

// ...

public function index(ViewsInterface $views): string
{
    return $views->render('home');
}

To render the view with passed data, use the second array argument:

php
use Spiral\Views\ViewsInterface;

// ...

public function index(ViewsInterface $views): string
{
    return $views->render('home', [
        'key' => 'value'
    ]);
}

Namespaces

To render view from specific namespace prepend it to view name using : separator:

php
return $views->render('namespace:home', [
    'key' => 'value'
]);

View Object

In some cases it might be more performant to cache the view in stateless component, obtain view object (Spiral\Views\ViewInterface) using method get of ViewsInterface:

php
$view = $views->get('home');

To render obtained view call render method:

php
return $view->render([
    'key' => 'value'
]);