Range (SP-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K (hat „Sp:range“ nach „Range (SP-Tag)“ verschoben) |
|||
(5 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
==Name== | ==Name== | ||
− | <sp:range> - Der Range-Tag reduziert eine [[ | + | <sp:range> - Der Range-Tag reduziert eine [[Collection]] anhand von Positions-Angaben. |
==Syntax== | ==Syntax== | ||
<source lang="xml"> | <source lang="xml"> | ||
− | <sp: | + | <sp:range name="liste" collection="liste" range="bereich" /> |
</source> | </source> | ||
==Beschreibung== | ==Beschreibung== | ||
− | + | Der Range-Tag reduziert eine Collection anhand von Positions-Angaben. Die einzelnen Positionen werden durch Kommata getrennt (z.B 1,3). Ganze Bereiche werden mit - angegeben (z.B. 5-7 -> 5,6,7). Ein Bereich kann in umgekehrter Reihenfolge erzeugt werden, indem der Bereich mit der höheren Position beginnt (z.B. 7-5). Diese Angaben können kombiniert werden (z.B. 1,3,7-5 -> 1,3,7,6,5). Die Liste beginnt mit der Position 0. Das Ende einer Liste kann mit $ angegeben werden. | |
+ | |||
+ | Im Gegensatz zu [[sp:filter]], wird hier die Liste anhand der Position der Elemente reduziert. | ||
==Attribute== | ==Attribute== | ||
Zeile 15: | Zeile 17: | ||
! Name || Type || Required || Default || ab IES Version | ! Name || Type || Required || Default || ab IES Version | ||
|- | |- | ||
− | | <code> | + | | <code>name</code> |
− | | [[ | + | | [[Collection]] |
| Ja | | Ja | ||
| None | | None | ||
| 1 | | 1 | ||
|- | |- | ||
− | | <code> | + | | <code>collection</code> |
− | | [[ | + | | [[Collection]] |
− | | | + | | Ja |
| None | | None | ||
| 1 | | 1 | ||
|- | |- | ||
− | | <code> | + | | <code>range</code> |
− | | [[ | + | | [[Text]] |
− | | | + | | Ja |
| None | | None | ||
| 1 | | 1 | ||
− | |- | + | |- |
− | | <code> | + | | <code>scope</code> |
− | | [[ | + | | [[Scope]] |
| Nein | | Nein | ||
− | | | + | | request |
− | | | + | | 2.14 |
|} | |} | ||
− | ;<code> | + | ;<code>name</code> |
− | : | + | :Name der Liste die aus der Auswahl erstellt wird. |
+ | |||
+ | ;<code>collection</code> | ||
+ | :Name der Liste die verarbeitet werden soll. | ||
− | ;<code> | + | ;<code>range</code> |
− | : | + | :Bereichsdefinition. |
+ | |||
+ | ;<code>scope</code> | ||
+ | :[[Scope|Namensraum]], in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope möglich (<code>page</code>, <code>request</code>). | ||
==Beispiele== | ==Beispiele== | ||
− | === | + | ===Liste in Bereiche aufteilen=== |
Template Quelltext | Template Quelltext | ||
<source lang="xml"> | <source lang="xml"> | ||
− | + | <sp:collection name="month" action="add" value="Januar"/> | |
− | </ | + | <sp:collection name="month" action="add" value="Februar"/> |
− | + | <sp:collection name="month" action="add" value="März"/> | |
− | + | <sp:collection name="month" action="add" value="April"/> | |
− | < | + | <sp:collection name="month" action="add" value="Mai"/> |
− | + | <sp:collection name="month" action="add" value="Juni"/> | |
− | </ | + | <sp:collection name="month" action="add" value="Juli"/> |
+ | <sp:collection name="month" action="add" value="August"/> | ||
+ | <sp:collection name="month" action="add" value="September"/> | ||
+ | <sp:collection name="month" action="add" value="Oktober"/> | ||
+ | <sp:collection name="month" action="add" value="November"/> | ||
+ | <sp:collection name="month" action="add" value="Dezember"/> | ||
− | === | + | <sp:range name="spring" collection="month" range="2,3,4"/> |
+ | <sp:range name="summer" collection="month" range="5-7"/> | ||
+ | <sp:range name="autumn" collection="month" range="8-10"/> | ||
+ | <sp:range name="winter" collection="month" range="$,0,1"/> | ||
− | + | Frühling: <sp:print name="spring"/> | |
− | < | + | Sommer: <sp:print name="summer"/> |
− | + | Herbst: <sp:print name="autumn"/> | |
+ | Winter: <sp:print name="winter"/> | ||
</source> | </source> | ||
Ausgabe | Ausgabe | ||
<source lang="text"> | <source lang="text"> | ||
− | + | Frühling: März,April,Mai | |
+ | Sommer: Juni,Juli,August | ||
+ | Herbst: September,Oktober,November | ||
+ | Winter: Dezember,Januar,Februar | ||
</source> | </source> | ||
− | + | ||
− | |||
− | |||
<noinclude> | <noinclude> | ||
[[Category:SP-Tags]] | [[Category:SP-Tags]] | ||
− | |||
− | |||
− | |||
[[Category:Qualität_des_Codes_prüfen]] | [[Category:Qualität_des_Codes_prüfen]] | ||
</noinclude> | </noinclude> | ||
− |
Aktuelle Version vom 20. November 2015, 15:19 Uhr
Name
<sp:range> - Der Range-Tag reduziert eine Collection anhand von Positions-Angaben.
Syntax
<sp:range name="liste" collection="liste" range="bereich" />
Beschreibung
Der Range-Tag reduziert eine Collection anhand von Positions-Angaben. Die einzelnen Positionen werden durch Kommata getrennt (z.B 1,3). Ganze Bereiche werden mit - angegeben (z.B. 5-7 -> 5,6,7). Ein Bereich kann in umgekehrter Reihenfolge erzeugt werden, indem der Bereich mit der höheren Position beginnt (z.B. 7-5). Diese Angaben können kombiniert werden (z.B. 1,3,7-5 -> 1,3,7,6,5). Die Liste beginnt mit der Position 0. Das Ende einer Liste kann mit $ angegeben werden.
Im Gegensatz zu sp:filter, wird hier die Liste anhand der Position der Elemente reduziert.
Attribute
Name | Type | Required | Default | ab IES Version |
---|---|---|---|---|
name
|
Collection | Ja | None | 1 |
collection
|
Collection | Ja | None | 1 |
range
|
Text | Ja | None | 1 |
scope
|
Scope | Nein | request | 2.14 |
name
- Name der Liste die aus der Auswahl erstellt wird.
collection
- Name der Liste die verarbeitet werden soll.
range
- Bereichsdefinition.
scope
- Namensraum, in dem die Variable definiert ist. Für diesen Tag ist der Page- und Request-Scope möglich (
page
,request
).
Beispiele
Liste in Bereiche aufteilen
Template Quelltext
<sp:collection name="month" action="add" value="Januar"/>
<sp:collection name="month" action="add" value="Februar"/>
<sp:collection name="month" action="add" value="März"/>
<sp:collection name="month" action="add" value="April"/>
<sp:collection name="month" action="add" value="Mai"/>
<sp:collection name="month" action="add" value="Juni"/>
<sp:collection name="month" action="add" value="Juli"/>
<sp:collection name="month" action="add" value="August"/>
<sp:collection name="month" action="add" value="September"/>
<sp:collection name="month" action="add" value="Oktober"/>
<sp:collection name="month" action="add" value="November"/>
<sp:collection name="month" action="add" value="Dezember"/>
<sp:range name="spring" collection="month" range="2,3,4"/>
<sp:range name="summer" collection="month" range="5-7"/>
<sp:range name="autumn" collection="month" range="8-10"/>
<sp:range name="winter" collection="month" range="$,0,1"/>
Frühling: <sp:print name="spring"/>
Sommer: <sp:print name="summer"/>
Herbst: <sp:print name="autumn"/>
Winter: <sp:print name="winter"/>
Ausgabe
Frühling: März,April,Mai
Sommer: Juni,Juli,August
Herbst: September,Oktober,November
Winter: Dezember,Januar,Februar