You are browsing the Symfony 4 documentation, which changes significantly from Symfony 3.x. If your app doesn't use Symfony 4 yet, browse the Symfony 3.4 documentation.
Slots Helper
Slots Helper¶
More often than not, templates in a project share common elements, like the well-known header and footer. Using this helper, the static HTML code can be placed in a layout file along with "slots", which represent the dynamic parts that will change on a page-by-page basis. These slots are then filled in by different children template. In other words, the layout file decorates the child template.
Displaying Slots¶
The slots are accessible by using the slots helper ($view['slots']). Use
output() to
display the content of the slot on that place:
1 2 3 4 5 6 7 8 9 10 11 12 | <!-- views/layout.php -->
<!doctype html>
<html>
<head>
<title>
<?php $view['slots']->output('title', 'Default title') ?>
</title>
</head>
<body>
<?php $view['slots']->output('_content') ?>
</body>
</html>
|
The first argument of the method is the name of the slot. The method has an optional second argument, which is the default value to use if the slot is not available.
The _content slot is a special slot set by the PhpEngine. It contains
the content of the subtemplate.
Caution
If you're using the standalone component, make sure you registered the
SlotsHelper:
use Symfony\Component\Templating\Helper\SlotsHelper;
// ...
$templateEngine->set(new SlotsHelper());
Extending Templates¶
The extend() method is called in the
sub-template to set its parent template. Then
$view['slots']->set()
can be used to set the content of a slot. All content which is not explicitly
set in a slot is in the _content slot.
1 2 3 4 5 6 7 8 9 10 11 | <!-- views/page.php -->
<?php $view->extend('layout.php') ?>
<?php $view['slots']->set('title', $page->title) ?>
<h1>
<?= $page->title ?>
</h1>
<p>
<?= $page->body ?>
</p>
|
Note
Multiple levels of inheritance is possible: a layout can extend another layout.
For large slots, there is also an extended syntax:
1 2 3 | <?php $view['slots']->start('title') ?>
Some large amount of HTML
<?php $view['slots']->stop() ?>
|
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.