From: Armin Ronacher <armin.ronacher@active-4.com>
Date: Thu, 19 Jun 2008 07:41:56 +0000 (+0200)
Subject: Documented differences of cycling between Django and Jinja2.
X-Git-Tag: 2.0~16
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f288b7aafaba379bfa97ba31e6f5fb620e10b4ed;p=thirdparty%2Fjinja.git

Documented differences of cycling between Django and Jinja2.

--HG--
branch : trunk
---

diff --git a/docs/switching.rst b/docs/switching.rst
index 0c496317..ba3cfb1f 100644
--- a/docs/switching.rst
+++ b/docs/switching.rst
@@ -181,6 +181,27 @@ For loops work very similar to Django, the only incompatibility is that in
 Jinja2 the special variable for the loop context is called `loop` and not
 `forloop` like in Django.
 
+Cycle
+~~~~~
+
+The ``{% cycle %}`` tag does not exist in Jinja because of it's implicit
+nature.  However you can achieve mostly the same by using the `cycle`
+method on a loop object.
+
+The following Django template::
+
+    {% for user in users %}
+        <li class="{% cycle 'odd' 'even' %}">{{ user }}</li>
+    {% endfor %}
+
+Would look like this in Jinja::
+
+    {% for user in users %}
+        <li class="{{ loop.cycle('odd', 'even') }}">{{ user }}</li>
+    {% endfor %}
+
+There is no equivalent of ``{% cycle ... as variable %}``.
+
 
 Mako
 ----