Range (SP-Tag): Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
 
(4 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Name==
 
==Name==
<sp:range> - Der Range-Tag reduziert eine [[List|Liste]] anhand von Positions-Angaben.
+
<sp:range> - Der Range-Tag reduziert eine [[Collection]] anhand von Positions-Angaben.
  
 
==Syntax==
 
==Syntax==
Zeile 8: Zeile 8:
  
 
==Beschreibung==
 
==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.
+
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.
 
Im Gegensatz zu [[sp:filter]], wird hier die Liste anhand der Position der Elemente reduziert.
Zeile 17: Zeile 17:
 
! Name || Type || Required || Default || ab IES Version
 
! Name || Type || Required || Default || ab IES Version
 
|-
 
|-
| <code>xxx</code>
+
| <code>name</code>
| [[Attribute]]
+
| [[Collection]]
 
| Ja
 
| Ja
 
| None
 
| None
 
| 1
 
| 1
 
|-
 
|-
| <code>xxx</code>
+
| <code>collection</code>
| [[Text]]
+
| [[Collection]]
| Nein
+
| Ja
 
| None
 
| None
 
| 1
 
| 1
 
|-
 
|-
| <code>xxx</code>
+
| <code>range</code>
| [[Expression]]
+
| [[Text]]
| Nein
+
| Ja
 
| None
 
| None
 
| 1
 
| 1
|-
+
|-  
| <code>xxx</code>
+
| <code>scope</code>
| [[Locale]]
+
| [[Scope]]
 
| Nein
 
| Nein
| None
+
| request
| 1
+
| 2.14
 
|}
 
|}
  
;<code>xxx</code>
+
;<code>name</code>
:xxx.
+
:Name der Liste die aus der Auswahl erstellt wird.
  
;<code>xxx</code>
+
;<code>collection</code>
:xxx.
+
:Name der Liste die verarbeitet werden soll.
 +
 
 +
;<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==
  
===Beispiel A===
+
===Liste in Bereiche aufteilen===
  
 
Template Quelltext
 
Template Quelltext
 
<source lang="xml">
 
<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"/>
 +
<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"/>
  
Ausgabe
+
<sp:range name="spring" collection="month" range="2,3,4"/>
<source lang="text">
+
<sp:range name="summer" collection="month" range="5-7"/>
xxx
+
<sp:range name="autumn" collection="month" range="8-10"/>
</source>
+
<sp:range name="winter" collection="month" range="$,0,1"/>
  
===Beispiel B===
+
Frühling: <sp:print name="spring"/>
 
+
Sommer: <sp:print name="summer"/>
Template Quelltext
+
Herbst: <sp:print name="autumn"/>
<source lang="xml">
+
Winter: <sp:print name="winter"/>
xxx
 
 
</source>
 
</source>
  
 
Ausgabe
 
Ausgabe
 
<source lang="text">
 
<source lang="text">
xxx
+
Frühling: März,April,Mai
 +
Sommer: Juni,Juli,August
 +
Herbst: September,Oktober,November
 +
Winter: Dezember,Januar,Februar
 
</source>
 
</source>
  
<!--
+
 
bitte die passenden Kategorien auswählen und Kommentar entfernen
 
--------------------------------------------------------------
 
 
<noinclude>
 
<noinclude>
 
[[Category:SP-Tags]]
 
[[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]]
 
[[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