Range (SP-Tag): Unterschied zwischen den Versionen

Version vom 8. Juni 2008, 18:27 Uhr

Name

<sp:range> - Der Range-Tag reduziert eine Liste anhand von Positions-Angaben.

Syntax

<sp:range name="liste" collection="liste" range="bereich" />

Beschreibung

Der Range-Tag reduziert eine Liste anhand von Positionsangaben. 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

@@ Zeile 17: / Zeile 17: @@
 ! Name || Type || Required || Default || ab IES Version
 |-
-| <code>xxx</code>
+| <code>name</code>
-| [[Attribute]]
+| [[Collection]]
 | Ja
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>collection</code>
-| [[Text]]
+| [[Collection]]
-| Nein
+| Ja
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>range</code>
-| [[Expression]]
+| [[Text]]
-| Nein
+| Ja
-| None
-| 1
-|-
-| <code>xxx</code>
-| [[Locale]]
-| Nein
 | None
 | 1
 |}
-;<code>xxx</code>
+;<code>name</code>
-:xxx.
+:Name der Liste die aus der Auswahl erstellt wird.
+;<code>collection</code>
+:Name der Liste die verarbeitet werden soll.
-;<code>xxx</code>
+;<code>range</code>
-:xxx.
+:Bereichsdefinition.
 ==Beispiele==
-===Beispiel A===
+===Liste in Bereiche aufteilen===
 Template Quelltext
 <source lang="xml">
-xxx
+<sp:collection name="month" action="add" value="Januar"/>
-</source>
+<sp:collection name="month" action="add" value="Februar"/>
+<sp:collection name="month" action="add" value="März"/>
-Ausgabe
+<sp:collection name="month" action="add" value="April"/>
-<source lang="text">
+<sp:collection name="month" action="add" value="Mai"/>
-xxx
+<sp:collection name="month" action="add" value="Juni"/>
-</source>
+<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"/>
-===Beispiel B===
+<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"/>
-Template Quelltext
+Frühling: <sp:print name="spring"/>
-<source lang="xml">
+Sommer: <sp:print name="summer"/>
-xxx
+Herbst: <sp:print name="autumn"/>
+Winter: <sp:print name="winter"/>
 </source>
 Ausgabe
 <source lang="text">
-xxx
+Frühling: März,April,Mai
+Sommer: Juni,Juli,August
+Herbst: September,Oktober,November
+Winter: Dezember,Januar,Februar
 </source>
-<!--
-bitte die passenden Kategorien auswählen und Kommentar entfernen
---------------------------------------------------------------
 <noinclude>
 [[Category:SP-Tags]]
-[[Category:SPT-Tags]]
 [[Category:Qualität_des_Inhalts_prüfen]]
 [[Category:Qualität_der_Sprache_prüfen]]
 [[Category:Qualität_des_Codes_prüfen]]
 </noinclude>
- -->