From: Armin Ronacher <armin.ronacher@active-4.com>
Date: Sun, 11 May 2008 21:55:02 +0000 (+0200)
Subject: documented recursive loops
X-Git-Tag: 2.0rc1~69
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=1de4c644c91e94b97e2a95e318a005dc617ccebf;p=jinja2.git

documented recursive loops

--HG--
branch : trunk
---

diff --git a/docs/templates.rst b/docs/templates.rst
index ea19e2d..90d4099 100644
--- a/docs/templates.rst
+++ b/docs/templates.rst
@@ -455,6 +455,22 @@ by using `else`::
     {% endif %}
     </ul>
 
+It is also possible to use loops recursively.  This is useful if you are
+dealing with recursive data such as sitemaps.  To use loops recursively you
+basically have to add the `recursive` modifier to the loop definition and
+call the `loop` variable with the new iterable where you want to recurse.
+
+The following example implements a sitemap with recursive loops::
+
+    <ul class="sitemap">
+    {%- for item in sitemap recursive %}
+        <li><a href="{{ item.href|e }}">{{ item.title }}</a>
+        {%- if item.children -%}
+            <ul class="submenu">{{ loop(item.children) }}</ul>
+        {%- endif %}</li>
+    {%- endfor %}
+    </ul>
+
 
 If
 ~~