art : foreach

jart.handlers.control.ForEach

Beschreibung

Die art:foreach Klasse kann verwendet werden um einen Block von Anweisungen auszuführen. Die Anzahl der Wiederholungen wird mittels eines Strings definiert, der nach verschiedenen zu definierenden Bedingungen gesplittet wird.

Attribute

Globale Attribute

@values (erforderlich)

Im "values"-Attribut wird der String angegeben der mittels des "splitter"-Attributs aufgeteilt wird.

@splitter (optional) (default: ,)

Im "splitter"-Attribut kann der Splitter definiert werden. Aufgrund des Splitters wird der String zerteilt.

@regex (optional)

Wenn eine Regular Expression verwendet werden soll um den String zu zerlegen, kann im "regex"-Attribut eine solche definiert werden.

@param (optional)

Um die aktuelle Position nicht in der Variable $param zu speichern, kann hier ein anderer Variablenname gewählt werden.

Beispiele

<art:plain name="data">
   <art:variable name="x" value="Lorem#ipsum#dolor#sit#amet" /> 
   <art:foreach splitter="#" values="{$x}">
      <art:plain name="word" value="{$param}" /> 
   </art:foreach>
</art:plain>

Ergebnis (XML):
<data>
   <word value="Lorem" /> 
   <word value="ipsum" /> 
   <word value="dolor" /> 
   <word value="sit" /> 
   <word value="amet" /> 
</data>

Mit Regular-Expression Splitter:

<art:plain name="data">
   <art:variable name="x" value="Lorem#ipsum#dolor#sit#amet" /> 
   <art:foreach regex="W" values="{$x}">
      <art:plain name="word" value="{$param}" /> 
   </art:foreach>
</art:plain>

Ergebnis (XML):
<data>
   <word value="Lorem" /> 
   <word value="ipsum" /> 
   <word value="dolor" /> 
   <word value="sit" /> 
   <word value="amet" /> 
</data>