Range (SP-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

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
name
Name der Liste die aus der Auswahl erstellt wird.
collection
Name der Liste die verarbeitet werden soll.
range
Bereichsdefinition.

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