Iterator (SP-Code) - Versionsgeschichte

Schleusner: Hob den Schutz von „Iterator (SP-Code)“ auf

2010-02-24T10:31:43Z

Hob den Schutz von „Iterator (SP-Code)“ auf

Veltrup: /* Beschreibung */

2009-11-16T13:16:16Z

Beschreibung

Veltrup: /* Beschreibung */

2009-11-16T13:15:55Z

Beschreibung

Jankowski am 12. Februar 2009 um 12:54 Uhr

2009-02-12T12:54:39Z

Veltrup am 25. Juni 2008 um 07:37 Uhr

2008-06-25T07:37:57Z

Veltrup am 25. Juni 2008 um 07:34 Uhr

2008-06-25T07:34:43Z

Veltrup am 25. Juni 2008 um 06:31 Uhr

2008-06-25T06:31:36Z

Veltrup am 25. Juni 2008 um 06:31 Uhr

2008-06-25T06:31:17Z

Liebold am 8. Juni 2008 um 14:20 Uhr

2008-06-08T14:20:31Z

Liebold am 7. Juni 2008 um 21:10 Uhr

2008-06-07T21:10:22Z

@@ Zeile 45: / Zeile 45: @@
 Beispiel für eine <code>addItem</code> Aktion:
-<source lang="xml">
+<source lang="text">
    <sp:iterator collection="mylist" min="2">

@@ Zeile 11: / Zeile 11: @@
 ==Beschreibung==
 Der Iterator-Tag erzeugt Wiederholfelder für Eingabemasken. Alle Eingabefelder innerhalb von <code>sp:iterator</code>, die mit sp- und spt- Tags erzeugt wurden, bilden einen [[List|Listen-Eintrag]]. Die Eingabefelder werden wiederholt und bilden so eine [[List|Liste]]. <code>sp:iterator</code>-Tags können weitere <code>sp:iterator</code>-Tags enthalten, um verschachtelte Listen zu erzeugen. Auf die Liste können mit Hilfe von Http-Request-Parametern Aktionen ausgeführt werden. Welche Aktion ausgeführt werden soll, wird mit <code>[[InformationHandler#SYS_INFE_listAction|SYS_INFE_listAction]]</code> angegeben. Mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> wird das Element bestimmt für das die Aktion gilt. Ein gültiger Wert für <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> ist beispielsweise <code>sp_mainIterator[2]</code>. Für ein in mehreren <code>sp:iterator</code> verschachteltes Element wäre zum Beispiel <code>sp_mainIterator[3].sp_subIterator[2]</code> ein gültiger Wert.
 Folgende Aktionen sind möglich:
@@ Zeile 41: / Zeile 43: @@
 Die Standarderweiterung von <code>sp:iterator</code> ist <code>[[spt:iterator]]</code>. Dieser Tag erzeugt Rahmen und Button, mit denen die Iterator-Funktionen ausgeführt werden können.
 ==Attribute==

@@ Zeile 10: / Zeile 10: @@
 ==Beschreibung==
-Der Iterator-Tag erzeugt Wiederholfelder für Eingabemasken. Alle Eingabefelder innerhalb von <code>sp:iterator</code>, die mit sp- und spt- Tags erzeugt wurden, bilden einen [[List|Listen-Eintrag]]. Die Eingabefelder werden wiederholt und bilden so eine [[List|Liste]]. <code>sp:iterator</code>-Tags können weitere <code>sp:iterator</code>-Tags enthalten, um verschachtelte Listen zu erzeugen. Auf die Liste können mit Hilfe von Http-Request-Parametern Aktionen ausgeführt werden. Welche Aktion ausgeführt werden soll, wird mit <code>[[InformationHandler#SYS_INFE_listAction|SYS_INFE_listAction]]</code> angegeben. Mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> wird das Element bestimmt für das die Aktion gilt. Ein gütiger Wert für <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> ist Beispielsweise <code>sp_mainIterator[2]</code>. Für ein in mehreren <code>sp:iterator</code> verschachteltes Element ist ein gültiger Wert beispielsweise <code>sp_mainIterator[3].sp_subIterator[2]</code>.
+Der Iterator-Tag erzeugt Wiederholfelder für Eingabemasken. Alle Eingabefelder innerhalb von <code>sp:iterator</code>, die mit sp- und spt- Tags erzeugt wurden, bilden einen [[List|Listen-Eintrag]]. Die Eingabefelder werden wiederholt und bilden so eine [[List|Liste]]. <code>sp:iterator</code>-Tags können weitere <code>sp:iterator</code>-Tags enthalten, um verschachtelte Listen zu erzeugen. Auf die Liste können mit Hilfe von Http-Request-Parametern Aktionen ausgeführt werden. Welche Aktion ausgeführt werden soll, wird mit <code>[[InformationHandler#SYS_INFE_listAction|SYS_INFE_listAction]]</code> angegeben. Mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> wird das Element bestimmt für das die Aktion gilt. Ein gültiger Wert für <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> ist beispielsweise <code>sp_mainIterator[2]</code>. Für ein in mehreren <code>sp:iterator</code> verschachteltes Element wäre zum Beispiel <code>sp_mainIterator[3].sp_subIterator[2]</code> ein gültiger Wert.
 Folgende Aktionen sind möglich:
 ;swapList
-:Vertauscht die Reihfolge der Listen-Elemente. Das erste Element wird zum letzten das zweite Element zum zweitletzten, usw., das letzte Element wird zum ersten. Für diese Aktion wird <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> nicht benötigt.
+:Vertauscht die Reihenfolge der Listen-Elemente. Das erste Element wird zum letzten das zweite Element zum zweitletzten, ..., das letzte Element wird zum ersten. Für diese Aktion wird <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> nicht benötigt.
 ;addItem
-:Fügt ein leeres Element an das Ende der Liste. Für diese Aktion wird <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> nicht benötigt.
+:Fügt ein leeres Element am Ende der Liste ein. Für diese Aktion wird <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> nicht benötigt.
 ;moveItemDown
-:Verschiebt das mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Elemente um eine Position nach unten. Ist das Element das letzte der Liste, so wird es an die erste Stelle der Liste verschoben.
+:Verschiebt das mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Elemente um eine Position nach unten. Ist das Element das letzte der Liste, wird es an die erste Stelle der Liste verschoben.
 ;moveItemUp
-:Verschiebt das mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Element um eine Position nach oben. Ist das Element das erste der Liste, so wird es an die letzt Stelle der Liste verschoben.
+:Verschiebt das mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Element um eine Position nach oben. Ist das Element das erste der Liste, wird es an die letzt Stelle der Liste verschoben.
 ;removeItem
@@ Zeile 30: / Zeile 30: @@
 ;insertItem
-:Fügt ein leeres Element an die mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Stelle ein. Das uhrsprüngliche Element an dieser Stelle wird um eine Position nach unten verschoben.
+:Fügt ein leeres Element an die mit <code>[[InformationHandler#SYS_INFE_listID|SYS_INFE_listID]]</code> angegebene Stelle ein. Das ursprüngliche Element an dieser Stelle wird um eine Position nach unten verschoben.
-<code>sp:iterator</code> wird so oft durchlaufen, wie die Anzahl der Element der Liste, die mit <code>collection</code> angegebene wurde. Existiert die Liste (noch) nicht, so wird <code>sp:iterator</code> nicht durchlaufen. Um eine Liste zu erzeugen, kann mit <code>addItem</code> eine neue Liste mit einem Element erzeugt werden. Eine weitere Möglichkeit einen oder mehrere Iteratordurchläufe zu erzwingen ist die Angabe des <code>min</code>-Attributes, das bestimmt wieviele Listenelement minimal ausgegeben werden sollen, auch wenn noch keine Liste existiert.
+Die Anzahl der Durchläufe des <code>sp:iterator</code> entspricht der Anzahl der Elemente der Liste, die mit <code>collection</code> angegebene wurden. Existiert die Liste (noch) nicht, so wird <code>sp:iterator</code> nicht durchlaufen. Um eine Liste zu erzeugen, kann mit <code>addItem</code> eine neue Liste mit einem Element erzeugt werden. Eine weitere Möglichkeit einen oder mehrere Iteratordurchläufe zu erzwingen, ist die Angabe des <code>min</code>-Attributes, das bestimmt wieviele Listenelement minimal ausgegeben werden sollen, auch wenn noch keine Liste existiert.
 Da in den meisten Fällen ein Iteratordurchlauf (min = 1) gewünscht ist, wenn noch keine Liste existiert, sind die Listenaktionen für diesen Fall optimiert. Daraus ergeben sich folgende Sonderfälle:
@@ Zeile 38: / Zeile 38: @@
 #Die Liste existiert noch nicht, aber durch min = 1 wird der Iterator einmal durchlaufen. Wenn die Felder des Iterators nicht gefüllt werden, wird keine Liste erzeugt und kein leeres Element angelegt. Diese Verhalten gilt nur für die Listen, die mit [[InformationHandler#SYS_INFE_emptyList|SYS_INFE_emptyList]] als leer markiert wurden. Mehrere Listen werden durch Kommata getrennt. Gültige Werte für [[InformationHandler#SYS_INFE_emptyList|SYS_INFE_emptyList]] sind z.B. <code>101020100000020322-1015:sp_mainIterator</code> oder <code>101020100000020322-1015:sp_mainIterator[2].sp_subIterator</code>.
 #addItem und insertItem erzeugen zwei leere Listenelemente, wenn noch keine Liste existiert.
-#Es gibt keine leeren Listen. Wird das letzte Element der Liste gelöscht, wird die gesammte Liste gelöscht.
+#Es gibt keine leeren Listen. Wird das letzte Element der Liste gelöscht, wird die gesamte Liste gelöscht.
 Die Standarderweiterung von <code>sp:iterator</code> ist <code>[[spt:iterator]]</code>. Dieser Tag erzeugt Rahmen und Button, mit denen die Iterator-Funktionen ausgeführt werden können.
@@ Zeile 76: / Zeile 76: @@
 ;<code>item</code>
-:Die in <code>collection</code> 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]]).
+:Die in <code>collection</code> 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]]).
 ;<code>min</code>
-:Die Anzahl der mindestens zu iterierenden Elemente. Enthält die zu iterierende Liste weniger Elemente als in <code>min</code> angegeben werden so viele leere Elemente hinzugefügt, bis mindestens die in <code>min</code> angegebene Anzahl von Elementen vorhanden ist.
+:Die Anzahl der mindestens zu iterierenden Elemente. Enthält die zu iterierende Liste weniger Elemente als in <code>min</code> angegeben, werden so viele leere Elemente hinzugefügt, bis mindestens die in <code>min</code> angegebene Anzahl von Elementen vorhanden ist.
 ;<code>max</code>
@@ Zeile 114: / Zeile 114: @@
 <noinclude>
 [[Category:SP-Tags]]
 [[Category:Qualität_des_Codes_prüfen]]
 [[Category:Beispiel_überarbeiten_testen]]
 </noinclude>

@@ Zeile 76: / Zeile 76: @@
 ;<code>item</code>
-:Die in <code>collection</code> angegebene Liste wird Element für Element durchlaufen. Mit dem in diesem Attribut angegebenen Namen kann auf das aktuelle Element der Liste zugegriffen werden.
+:Die in <code>collection</code> 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]]).
 ;<code>min</code>

@@ Zeile 67: / Zeile 67: @@
 | <code>max</code>
 | [[Number]]
 | Nein
 | None
@@ Zeile 79: / Zeile 73: @@
 ;<code>collection</code>
-:Die zu iterierende [[List|Liste]].
+:Die zu iterierende [[List|Liste]]. Dieses Attribut entspricht dem <code>name</code>-Attribut des [[spt:iterator]]-Tags.
 ;<code>item</code>
@@ Zeile 89: / Zeile 83: @@
 ;<code>max</code>
 :Die Anzahl der maximal zu iterierenden Elemente. Enthält die zu iterierende Liste mehr Elemente als in <code>max</code> angegeben, so wird die Anzahl der Elemente auf die Anzahl <code>max</code> gekürzt.
 ==Beispiele==

← Nächstältere Version	Version vom 24. Februar 2010, 10:31 Uhr
(kein Unterschied)

@@ Zeile 95: / Zeile 95: @@
 ==Beispiele==
-====Einfügen von Textfeldern====
+===Einfügen von Textfeldern===
 Template Quelltext
@@ Zeile 107: / Zeile 107: @@
 </source>
-====Einfügen von Textfeldern mit Item====
+===Einfügen von Textfeldern mit Item===
 Template Quelltext

@@ Zeile 1: / Zeile 1: @@
 ==Name==
-<sp:iterator> - xxx-Tag
+<sp:iterator> - Erzeugt Wiederholfelder
 ==Syntax==
 <source lang="xml">
-<sp:xxx name="variable" encoding="html"/>
+<sp:iterator collection="sp_mainIterator">
 </source>
 ==Beschreibung==
-xxx
+Der Iterator-Tag erzeugt Wiederholfelder für Eingabemasken. Alle Eingabefelder innerhalb von <code>sp:iterator</code>, die mit sp- und spt- Tags erzeugt wurden, bilden einen [[List|Listen-Eintrag]]. Die Eingabefelder werden wiederholt und bilden so eine [[List|Liste]]. <code>sp:iterator</code>-Tags können weitere <code>sp:iterator</code>-Tags enthalten, um verschachtelte Listen zu erzeugen. Auf die Liste können mit Hilfe von Http-Request-Parametern Aktionen ausgeführt werden. Welche Aktion ausgeführt werden soll, wird mit <code>[[SYS_INFE_listAction]]</code> angegeben. Mit <code>[[SYS_INFE_listID]]</code> wird das Element bestimmt für das die Aktion gilt. Ein gütiger Wert für <code>SYS_INFE_listID</code> ist Beispielsweise <code>sp_mainIterator[2]</code>. Für ein in mehreren <code>sp:iterator</code> verschachteltes Element ist ein gültiger Wert beispielsweise <code>sp_mainIterator[3].sp_subIterator[2]</code>.
 ==Attribute==
@@ Zeile 15: / Zeile 47: @@
 ! Name || Type || Required || Default || ab IES Version
 |-
-| <code>xxx</code>
+| <code>collection</code>
-| [[Attribute]]
+| [[Variable]]
 | Ja
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>item</code>
-| [[Text]]
+| [[Variable]]
 | Nein
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>min</code>
-| [[Expression]]
+| [[Number]]
 | Nein
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>locale</code>
 | [[Locale]]
 | Nein
@@ Zeile 40: / Zeile 78: @@
 |}
-;<code>xxx</code>
+;<code>collection</code>
-:xxx.
+:Die zu iterierende [[List|Liste]].
-;<code>xxx</code>
+;<code>max</code>
-:xxx.
+:Die Anzahl der maximal zu iterierenden Elemente. Enthält die zu iterierende Liste mehr Elemente als in <code>max</code> angegeben, so wird die Anzahl der Elemente auf die Anzahl <code>max</code> gekürzt.
 ==Beispiele==
-====Beispiel A====
+====Einfügen von Textfeldern====
 Template Quelltext
 <source lang="xml">
-xxx
+<sp:iterator collection="sp_mainIterator" min="1">
 </source>
-Ausgabe
+====Einfügen von Textfeldern mit Item====
 Template Quelltext
 <source lang="xml">
-xxx
+<sp:iterator collection="sp_mainIterator" item="it" min="1">
 </source>
 <noinclude>
 [[Category:SP-Tags]]
 [[Category:Qualität_des_Inhalts_prüfen]]
 [[Category:Qualität_der_Sprache_prüfen]]
 [[Category:Qualität_des_Codes_prüfen]]
 </noinclude>