Range (SP-Tag)
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