mirror of
https://github.com/twigphp/Twig.git
synced 2026-11-11 12:56:56 +00:00
Fabien Potencier
02b084e2f5
This PR was merged into the 1.x branch.
Discussion
----------
added support for a custom template on the block() function
`block()` allows one to render a block of the current template.
This PR adds the possibility to use `block()` to render a block of another template:
```twig
{{ block('footer', template_name) }}
```
As it uses the same logic as for the regular `block()`, you can also use it in a test:
```twig
{% if block('footer', template_name) is defined %}
...
{% endif %}
```
This removes the needs to use the internal `Twig_Template::renderBlock()` method in the Symfony Web Profiler for instance. And combined with #2236, it allows us to really mark the whole `Twig_Template` class as being internal.
I'm aware that #1302 asked for being able to pass a context to `block()` (implemented in #1433), but I prefer not to in favor of adding the `with` tag (see #719 and #1054).
When the `with` will be implemented, the code in the Symfony Web Profiler will become something along the lines of:
```twig
{% with {
'collector': profile.getcollector(name),
'profiler_url': profiler_url,
'token': profile.token,
'name': name
} %}
{{ block('toolbar', template) }}
{% endwith %}
```
Commits
-------
5ed59be added support for a custom template on the block() function
42 lines
967 B
ReStructuredText
42 lines
967 B
ReStructuredText
``block``
|
|
=========
|
|
|
|
.. versionadded: 1.28
|
|
Using ``block`` with the ``defined`` test was added in Twig 1.28.
|
|
|
|
.. versionadded: 1.28
|
|
Support for the template argument was added in Twig 1.28.
|
|
|
|
When a template uses inheritance and if you want to print a block multiple
|
|
times, use the ``block`` function:
|
|
|
|
.. code-block:: jinja
|
|
|
|
<title>{% block title %}{% endblock %}</title>
|
|
|
|
<h1>{{ block('title') }}</h1>
|
|
|
|
{% block body %}{% endblock %}
|
|
|
|
The ``block`` function can also be used to display one block of another
|
|
template:
|
|
|
|
.. code-block:: jinja
|
|
|
|
{{ block("title", "common_blocks.twig") }}
|
|
|
|
Use the ``defined`` test to check if a block exists in the context of the
|
|
current template:
|
|
|
|
.. code-block:: jinja
|
|
|
|
{% if block("footer") is defined %}
|
|
...
|
|
{% endif %}
|
|
|
|
{% if block("footer", "common_blocks.twig") is defined %}
|
|
...
|
|
{% endif %}
|
|
|
|
.. seealso:: :doc:`extends<../tags/extends>`, :doc:`parent<../functions/parent>`
|