p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Refs #34574, Refs #34577 -- Mentioned escapeseq filter in escape/autoescape docs.

This commit is contained in:
Natalia 2023-05-24 13:59:56 -03:00 committed by Mariusz Felisiak
parent 1a59a324ce
commit 881cc139e2
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
docs/ref/templates/builtins.txt
View File

@ -56,6 +56,15 @@ is because the filter chaining sequence executes first :tfilter:`join` on
fed to :tfilter:`escape` filter, which does not apply a second round of
escaping.
In order to properly escape every element in a sequence, use the
:tfilter:`escapeseq` filter:
.. code-block:: html+django
{% autoescape off %}
{{ my_list|escapeseq|join:", " }}
{% endautoescape %}
.. templatetag:: block
``block``
@ -1859,7 +1868,9 @@ For example, you can apply ``escape`` to fields when :ttag:`autoescape` is off:
In such cases, chaining ``escape`` would not reescape strings that have
already been marked as safe.
To escape each element of a sequence, use the :tfilter:`escapeseq` filter.
This is especially important when using filters that operate on sequences,
for example :tfilter:`join`. If you need to escape each element in a
sequence, use the dedicated :tfilter:`escapeseq` filter.
.. templatefilter:: escapejs