vendor/twig/twig/doc/tags/sandbox.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

``sandbox``
===========

The ``sandbox`` tag can be used to enable the sandboxing mode for an included
template, when sandboxing is not enabled globally for the Twig environment:

.. code-block:: jinja

    {% sandbox %}
        {% include 'user.html' %}
    {% endsandbox %}

.. warning::

    The ``sandbox`` tag is only available when the sandbox extension is
    enabled (see the :doc:`Twig for Developers<../api>` chapter).

.. note::

    The ``sandbox`` tag can only be used to sandbox an include tag and it
    cannot be used to sandbox a section of a template. The following example
    won't work:

    .. code-block:: jinja

        {% sandbox %}
            {% for i in 1..2 %}
                {{ i }}
            {% endfor %}
        {% endsandbox %}