For (SP-Tag): Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
K (hat „Sp:for (SP-Tag)“ nach „For (SP-Tag)“ verschoben)
Zeile 4: Zeile 4:
 
==Syntax==
 
==Syntax==
 
<source lang="xml">
 
<source lang="xml">
<sp:xxx name="variable" encoding="html"/>
+
<sp:for index="counter" from="0" to="10"/>
 
</source>  
 
</source>  
  
 
==Beschreibung==
 
==Beschreibung==
xxx
+
Mit Hilfe des For-Tag kann eine Schleife definiert werden. <code>from</code> gibt den Startwert des Indexes an. Bei jedem Schleifendurchlauf wird <code>index</code> um den Wert <code>step</code> erhöht (bzw vermindert, wenn <code>step</code> negativ ist). Die Schleife wird solange durchlaufen bis <code>to</code> den Wert <code>index</code> erreicht hat. Alternativ zu to kann auch <code>condition</code> angegeben werden. In diesem Fall wird die Schleife solange durchlaufen, bis <code>condition</code> <code>false</code> ergibt.
  
 
==Attribute==
 
==Attribute==
Zeile 15: Zeile 15:
 
! Name || Type || Required || Default || ab IES Version
 
! Name || Type || Required || Default || ab IES Version
 
|-
 
|-
| <code>xxx</code>
+
| <code>index</code>
| [[Attribute]]
+
| [[Variablenname]]
 
| Ja
 
| Ja
 
| None
 
| None
 
| 1
 
| 1
 
|-
 
|-
| <code>xxx</code>
+
| <code>from</code>
| [[Text]]
+
| [[Expression]]
| Nein
+
| Ja
 +
| None
 +
| 1
 +
|-
 +
| <code>to</code>
 +
| [[Expression]]
 +
| Ja oder <code>condition</code>
 +
| None
 +
| 1
 +
|-
 +
| <code>condition</code>
 +
| [[Condition]]
 +
| Ja oder <code>to</code>
 
| None
 
| None
 
| 1
 
| 1
 
|-
 
|-
| <code>xxx</code>
+
| <code>step</code>
 
| [[Expression]]
 
| [[Expression]]
 
| Nein
 
| Nein
| None
+
| 1
 
| 1
 
| 1
 
|-
 
|-
| <code>xxx</code>
+
| <code>locale</code>
 
| [[Locale]]
 
| [[Locale]]
 
| Nein
 
| Nein
Zeile 40: Zeile 52:
 
|}
 
|}
  
;<code>xxx</code>
+
;<code>index</code>
:xxx.
+
:Name der Variable, die den aktuellen Zählerstand enthält.
 +
 
 +
;<code>from</code>
 +
:Startwert des Zählers.
 +
 
 +
;<code>to</code>
 +
:Endwert des Zählers.
 +
 
 +
;<code>condition</code>
 +
:Die For-Schleife wird solange durchlaufen, bis die Bedingung false ergibt.
 +
 
 +
;<code>step</code>
 +
:Schrittweite, in der gezählt werden soll. step kann für einen Rückwärtszähler negativ sein.
  
;<code>xxx</code>
+
;<code>locale</code>
:xxx.
+
:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.
  
 
==Beispiele==
 
==Beispiele==
  
====Beispiel A====
+
====Einfache from/to Schleife====
  
 
Template Quelltext
 
Template Quelltext
 
<source lang="xml">
 
<source lang="xml">
xxx
+
<sp:for index="i" from="1" to="3">
 +
  index: <sp:print name="i"/><br>
 +
</sp:for>
 
</source>
 
</source>
  
 
Ausgabe
 
Ausgabe
 
<source lang="text">
 
<source lang="text">
xxx
+
index: 1
 +
index: 2
 +
index: 3
 
</source>
 
</source>
  
====Beispiel B====
+
====Schleife mit Bedingung====
  
 
Template Quelltext
 
Template Quelltext
 
<source lang="xml">
 
<source lang="xml">
xxx
+
<sp:set name="start" value="10"/>
 +
<sp:set name="end" value="4"/>
 +
<sp:set name="step" value="-1"/>
 +
<sp:for index="i" from="${start}" condition="${i} >= (${end} + 1)" step="${step}">
 +
  index: <sp:print name="i"/><br>
 +
</sp:for>
 
</source>
 
</source>
  
 
Ausgabe
 
Ausgabe
 
<source lang="text">
 
<source lang="text">
xxx
+
index: 10
 +
index: 9
 +
index: 8
 +
index: 7
 +
index: 6
 +
index: 5
 
</source>
 
</source>
  

Version vom 6. Juni 2008, 19:04 Uhr

Name

<sp:for> - For-Schleife

Syntax

<sp:for index="counter" from="0" to="10"/>

Beschreibung

Mit Hilfe des For-Tag kann eine Schleife definiert werden. from gibt den Startwert des Indexes an. Bei jedem Schleifendurchlauf wird index um den Wert step erhöht (bzw vermindert, wenn step negativ ist). Die Schleife wird solange durchlaufen bis to den Wert index erreicht hat. Alternativ zu to kann auch condition angegeben werden. In diesem Fall wird die Schleife solange durchlaufen, bis condition false ergibt.

Attribute

Name Type Required Default ab IES Version
index Variablenname Ja None 1
from Expression Ja None 1
to Expression Ja oder condition None 1
condition Condition Ja oder to None 1
step Expression Nein 1 1
locale Locale Nein None 1
index
Name der Variable, die den aktuellen Zählerstand enthält.
from
Startwert des Zählers.
to
Endwert des Zählers.
condition
Die For-Schleife wird solange durchlaufen, bis die Bedingung false ergibt.
step
Schrittweite, in der gezählt werden soll. step kann für einen Rückwärtszähler negativ sein.
locale
Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

Beispiele

Einfache from/to Schleife

Template Quelltext

<sp:for index="i" from="1" to="3">
  index: <sp:print name="i"/><br>
</sp:for>

Ausgabe

index: 1
index: 2
index: 3

Schleife mit Bedingung

Template Quelltext

<sp:set name="start" value="10"/>
<sp:set name="end" value="4"/>
<sp:set name="step" value="-1"/>
<sp:for index="i" from="${start}" condition="${i} >= (${end} + 1)" step="${step}">
  index: <sp:print name="i"/><br>
</sp:for>

Ausgabe

index: 10
index: 9
index: 8
index: 7
index: 6
index: 5