Changes between Version 1 and Version 2 of GUI_-_Repeat

Timestamp:

Dec 10, 2014, 9:15:51 PM (9 years ago)

Author:

leper

Comment:

Nested repeat object support was added in r16034.

GUI_-_Repeat

@@ +1 @@
+[[TOC]]
+
 = Repeat =
 The repeat object is designed to simplify cases where you have a large number of very similar objects nearby each other.
 == Explanation ==
 The repeat object generates "count" copies of any objects nested within it. Since you can not have multiple copies of the same named object you insert "[n]" somewhere in the name. After parsing, the "n" is replaced with the index of the generated object in the repeat.
+
+You can also specify the variable that is replaced as the value of the `var` attribute. This is useful if you need nested repeat objects.
 
 '''Important:''' The repeat element does not automatically adjust child element sizing.
@@ -20 +24 @@
 </repeat>
 }}}
+
+== Example - Nested ==
+For example, the following XML could be simplified by using a repeat element.
+{{{
+#!xml
+<object name="myObj[0][0]" type="sprite" sprite="mySprite"/>
+<object name="myObj[0][1]" type="sprite" sprite="mySprite"/>
+<object name="myObj[1][0]" type="sprite" sprite="mySprite"/>
+<object name="myObj[1][1]" type="sprite" sprite="mySprite"/>
+}}}
+The next snippet uses the repeat element to create the same result.
+{{{
+#!xml
+<repeat count="2">
+    <repeat count="2" var="m">
+        <object name="myObj[n][m]" type="sprite" sprite="mySprite"/>
+    </repeat>
+</repeat>
+}}}