Provides a mechanism for repeating data bound templates.

• #{name}

Source Code

<ul control="iterator[property=rows]" on="l:iterator then render">
  <li id="item_#{iterator_index}" on="click then script[alert('#{name}')]">#{name}</li>
  <script>
    if ('#{name}' == 'Neil Patrick Harris') {
      jQuery("#item_#{iterator_index}").css("color", "red");
    }
  </script>
</ul>
 
<script>
$MQL("l:app.compiled", function() {
  $MQ('l:iterator',{'rows':[
    {name:'Neil Patrick Harris'},
    {name:'Fred Savage'},
    {name:'Kirk Cameron'}
  ]});
});
</script>

Create the control…

App.createControl(
	'myItertator',
	'iterator',
	{
	},
	function()
	{
	}
);

Get the handle to an instance of the control and save it to a local variable and set an Entourage Message listener to render the iterator using an arbitrary payload.

var iteratorInstance = null;
 
App.getControl('api_1','iterator',function()
{
	iteratorInstance = this;
});
 
$MQL('l:testapi1',function()
{
	var d =[{name:'api_1'},{name:'api_2'},{name:'api_3'}];
	iteratorInstance.render({'rows':d})
});

The iterator control is made up of a container div and may contain any arrangement of markup which will act as it's template. The control tag on the div indicates what kind of widget the div will become. The widget identity can accept the following initial parameters…

Initial options supported by the widget.

Functions either accept a single argument such as an integer or a string, otherwise they accept a one dimensional object literal. Any function that can be called as an action accepts the same parameters but in the action parameter format.