Browse Source

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

Natalia 1 year ago
parent
commit
881cc139e2
1 changed files with 12 additions and 1 deletions
  1. 12 1
      docs/ref/templates/builtins.txt

+ 12 - 1
docs/ref/templates/builtins.txt

@@ -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