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
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