Changes between Version 25 and Version 26 of MarkupTemplates

Timestamp:

Jul 28, 2006, 8:22:34 PM (18 years ago)

Author:

cmlenz

Comment:

Document the new py:with directive

MarkupTemplates

@@ -378 +378 @@
 }}}
 
+=== `py:with` ===
+
+The `py:with` directive lets you assign expressions to variables, which can be used to make expressions inside the directive less verbose and more efficient. For example, if you need use the expression `author.posts` more than once, and that actually results in a database query, assigning the results to a variable using this directive would probably help.
+
+For example:
+
+{{{
+#!xml
+<div xmlns:py="http://markup.edgewall.org/">
+  <span py:with="y=7; z=x+10">$x $y $z</span>
+</div>
+}}}
+
+Given `x=42` in the context data, this would produce:
+
+{{{
+#!xml
+<div>
+  <span>42 7 52</span>
+</div>
+}}}
+
+This directive can also be used as an element:
+
+{{{
+#!xml
+<div xmlns:py="http://markup.edgewall.org/">
+  <py:with vars="y=7; z=x+10">$x $y $z</py:with>
+</div>
+}}}
+
 === `py:match` ===