Iterator (SPT-Tag)

Name

<spt:iterator> - erzeugt Wiederholfelder

Syntax

<spt:iterator name="variable">
  ...
</spt:iterator>

Beschreibung

Der spt:iterator-Tag ermöglicht die wiederholte Ein- und Ausgabe von Input-Tags. Ein mit diesem Tag umschlossener Template-Abschnitt kann bei der Eingabe beliebig oft wiederholt und editiert werden. Aus diesen Eingaben wird eine Liste erstellt, die mit den SP-Tags für Listen durchlaufen werden kann (z.B. sp:loop, s. Beispiel). Iterationen können an beliebigen Stellen hinzugefügt oder gelöscht werden. Die Reihenfolge der Iterationen ist veränderbar.

Erläuterungen der Schaltflächen:

ans Ende verschieben

an dieser Stelle einfügen

löschen

vertauschen

Reihenfolge invertieren

an erste Position verschieben

Attribute

Name	Type	Required	Default	ab IES Version
`name`	Attribute	Ja	None	1
`item`	Variable	Nein	None	1
`min`	Number	Nein	0	1
`max`	Number	Nein	None	1

name: Name der Variablen, unter der die Liste auch für die Ausgabe erreichbar ist. Dieses Attribut entspricht dem collection-Attribut des sp:iterator-Tags.

item: Die in name angegebene Liste wird Element für Element durchlaufen. Mit dem, in diesem Attribut angegebenen Namen kann auf das aktuelle Element der Liste zugegriffen werden. Für das aktuelle Element können noch zusätzliche Informationen die den Schleifendurchlauf betreffen abgefragt werden (siehe IteratorItem).

min: Die Anzahl der mindestens zu iterierenden Elemente. Enthält die zu iterierende Liste weniger Elemente als in min angegeben werden so viele leere Elemente hinzugefügt, bis mindestens die in min angegebene Anzahl von Elementen vorhanden ist.

max: Die Anzahl der maximal zu iterierenden Elemente. Enthält die zu iterierende Liste mehr Elemente als in max angegeben, so wird die Anzahl der Elemente auf die Anzahl max gekürzt.

Beispiele

Artikel mit beliebig vielen Absätzen

Template Quelltext

<%-- Beginn Eingabe --%>
<sp:io type="in">
  Artikelüberschrift:<br>
  <sp:text name="headline"/><br>

  <%-- Beginn iterierter Abschnitt --%>
  <spt:iterator name="iterate" item="it">
    Absatzüberschrift:<br>
    <spt:text name="bodyhead"/><br>
    Absatztext:<br>
    <spt:smarteditor name="body" cols="50" rows="10"/>
  </spt:iterator>
  <%-- Ende iterierter Abschnitt --%>
</sp:io>
<%-- Ende Eingabe --%>

<%-- Beginn Ausgabe --%>
<sp:io type="out">

<h3><sp:print name="headline"/></h3><br>

<%-- Beginn Ausgabe iterierter Abschnitt --%>
<sp:loop collection="iterate" item="it">
    <p>
    <h4><sp:print name="it.index"/>: <sp:print name="it.bodyhead"/></h4>
    <sp:print name="it.body"/>
    </p>
</sp:loop>
<%-- Ende Ausgabe iterierter Abschnitt --%>

</sp:io>
<%-- Ende Ausgabe --%>