Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
autoescape.rst	1.65 KB	-rw-r--r--
block.rst	448 B	-rw-r--r--
do.rst	177 B	-rw-r--r--
embed.rst	6.84 KB	-rw-r--r--
extends.rst	7.19 KB	-rw-r--r--
filter.rst	463 B	-rw-r--r--
flush.rst	218 B	-rw-r--r--
for.rst	4.46 KB	-rw-r--r--
from.rst	275 B	-rw-r--r--
if.rst	1.92 KB	-rw-r--r--
import.rst	1.72 KB	-rw-r--r--
include.rst	2.47 KB	-rw-r--r--
index.rst	238 B	-rw-r--r--
macro.rst	2.61 KB	-rw-r--r--
sandbox.rst	764 B	-rw-r--r--
set.rst	1.64 KB	-rw-r--r--
spaceless.rst	1.14 KB	-rw-r--r--
use.rst	3.18 KB	-rw-r--r--
verbatim.rst	367 B	-rw-r--r--
with.rst	1.07 KB	-rw-r--r--

Code Editor : autoescape.rst

``autoescape``
==============

Whether automatic escaping is enabled or not, you can mark a section of a
template to be escaped or not by using the ``autoescape`` tag:

.. code-block:: jinja

{% autoescape %}
        Everything will be automatically escaped in this block
        using the HTML strategy
    {% endautoescape %}

{% autoescape 'html' %}
        Everything will be automatically escaped in this block
        using the HTML strategy
    {% endautoescape %}

{% autoescape 'js' %}
        Everything will be automatically escaped in this block
        using the js escaping strategy
    {% endautoescape %}

{% autoescape false %}
        Everything will be outputted as is in this block
    {% endautoescape %}

When automatic escaping is enabled everything is escaped by default except for
values explicitly marked as safe. Those can be marked in the template by using
the :doc:`raw<../filters/raw>` filter:

.. code-block:: jinja

{% autoescape %}
        {{ safe_value|raw }}
    {% endautoescape %}

Functions returning template data (like :doc:`macros<macro>` and
:doc:`parent<../functions/parent>`) always return safe markup.

.. note::

Twig is smart enough to not escape an already escaped value by the
 :doc:`escape<../filters/escape>` filter.

.. note::

Twig does not escape static expressions:

.. code-block:: jinja

{% set hello = "Hello" %}
 {{ hello }}
 {{ "world" }}

Will be rendered "Hello **world**".

.. note::

The chapter :doc:`Twig for Developers<../api>` gives more information
 about when and how automatic escaping is applied.

${this.title}

Code Editor : autoescape.rst