Loop (SP-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K (Hob den Schutz von „Loop (SP-Tag)“ auf) |
|||
(14 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 10: | Zeile 10: | ||
==Beschreibung== | ==Beschreibung== | ||
− | Mit Hilfe des Loop-Tags können [[Collection|Collections]] oder Zeichenketten die Trennzeichen enthalten Element für Element durchlaufen werden. Der Inhalt innerhalb des Start- und End- | + | Mit Hilfe des Loop-Tags können [[Collection|Collections]] oder Zeichenketten die Trennzeichen enthalten, Element für Element durchlaufen werden. Der Inhalt innerhalb des Start- und End-Tags wird für jedes Element der Liste ausgegeben. Mit dem Variablennamen, der über das Attribut <code>item</code> angegenben wird, kann sowohl auf das aktuelle Loop-Element zugegriffen werden, wie auch auf Werte die den Schleifendurchlauf betreffen (siehe [[IteratorItem]]). |
− | Der Loop-Tag kapselt die eigentlichen | + | Der Loop-Tag kapselt die eigentlichen Elemente der Liste in einem [[IteratorItem]]-Objekt. Dadurch können nicht nur die Attribute der Elemente sondern beispielsweise auch die Index-Position des aktuellen Elementes ausgegeben werden. |
==Attribute== | ==Attribute== | ||
{| class="prettytable" | {| class="prettytable" | ||
|- class="hintergrundfarbe1" | |- class="hintergrundfarbe1" | ||
− | ! Name || Type || Required || Default | + | ! Name || Type || Required || Default || ab IES Version |
|- | |- | ||
| <code>collection</code> | | <code>collection</code> | ||
| [[Collection]] | | [[Collection]] | ||
− | | | + | | Ja oder <code>list</code> |
| None | | None | ||
+ | | 1 | ||
|- | |- | ||
| <code>list</code> | | <code>list</code> | ||
− | | [[ | + | | [[Text]] |
− | | | + | | Ja oder <code>collection</code> |
| None | | None | ||
+ | | 1 | ||
|- | |- | ||
| <code>item</code> | | <code>item</code> | ||
− | | [[ | + | | [[Variable]] |
| Nein | | Nein | ||
| None | | None | ||
+ | | 1 | ||
|- | |- | ||
| <code>separator</code> | | <code>separator</code> | ||
− | | [[ | + | | [[Text]] |
| Nein | | Nein | ||
− | | | + | | <code>,</code> (Komma) |
+ | | 1 | ||
|- | |- | ||
| <code>locale</code> | | <code>locale</code> | ||
Zeile 43: | Zeile 47: | ||
| Nein | | Nein | ||
| None | | None | ||
+ | | 1 | ||
|} | |} | ||
Zeile 52: | Zeile 57: | ||
;<code>item</code> | ;<code>item</code> | ||
− | :Die in <code>collection</code> angegebene Liste wird Element für Element durchlaufen. Mit dem | + | :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>separator</code> | ;<code>separator</code> | ||
Zeile 59: | Zeile 64: | ||
;<code>locale</code> | ;<code>locale</code> | ||
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen. | :Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen. | ||
− | |||
==Beispiele== | ==Beispiele== | ||
− | + | ===sp:loop mit einem Collection-Objekt=== | |
Template Quelltext | Template Quelltext | ||
Zeile 80: | Zeile 84: | ||
</source> | </source> | ||
− | + | ===sp:loop mit einer Zeichenkette und Trennzeichen=== | |
Template Quelltext | Template Quelltext | ||
Zeile 100: | Zeile 104: | ||
<noinclude> | <noinclude> | ||
[[Category:SP-Tags]] | [[Category:SP-Tags]] | ||
− | [[Category: | + | [[Category:Qualität_des_Codes_prüfen]] |
− | |||
− | |||
</noinclude> | </noinclude> |
Aktuelle Version vom 24. Februar 2010, 12:20 Uhr
Name
<sp:loop> - Durchläuft eine Liste
Syntax
<sp:loop collection="tpool.elements" item="it">
...
</sp:loop>
Beschreibung
Mit Hilfe des Loop-Tags können Collections oder Zeichenketten die Trennzeichen enthalten, Element für Element durchlaufen werden. Der Inhalt innerhalb des Start- und End-Tags wird für jedes Element der Liste ausgegeben. Mit dem Variablennamen, der über das Attribut item
angegenben wird, kann sowohl auf das aktuelle Loop-Element zugegriffen werden, wie auch auf Werte die den Schleifendurchlauf betreffen (siehe IteratorItem).
Der Loop-Tag kapselt die eigentlichen Elemente der Liste in einem IteratorItem-Objekt. Dadurch können nicht nur die Attribute der Elemente sondern beispielsweise auch die Index-Position des aktuellen Elementes ausgegeben werden.
Attribute
Name | Type | Required | Default | ab IES Version |
---|---|---|---|---|
collection
|
Collection | Ja oder list
|
None | 1 |
list
|
Text | Ja oder collection
|
None | 1 |
item
|
Variable | Nein | None | 1 |
separator
|
Text | Nein | , (Komma)
|
1 |
locale
|
Locale | Nein | None | 1 |
collection
- Die zu iterierende Liste.
list
- Eine Zeichenkette mit dem in
separator
angegebenen Trennzeichen.
item
- Die in
collection
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).
separator
- Das Trennzeichen der übergebenen Liste.
locale
- Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.
Beispiele
sp:loop mit einem Collection-Objekt
Template Quelltext
<sp:loop collection="!{myPoolAnchor}.elements" item="it">
index: <sp:print name="it.index"/>, element-name: <sp:print name="it.name"/><br>
</sp:loop>
Ausgabe
index: 0, element-name: Artikel 1
index: 1, element-name: Artikel 2
index: 2, element-name: Artikel 3
index: 3, element-name: Artikel 4
sp:loop mit einer Zeichenkette und Trennzeichen
Template Quelltext
<sp:loop list="A|B|CD|EFG|xyz" separator="|" item="it">
index: <sp:print name="it.index"/>, token: <sp:print name="it"/><br>
</sp:loop>
Ausgabe
index: 0, token: A
index: 1, token: B
index: 2, token: CD
index: 3, token: EFG
index: 4, token: xyz