Webgate Anywhere 4.0 - WebTML Tag-Referenz
foreach

<tml:foreach>

Beschreibung :

Für alle Iterationen. Der Inhalt des Tags wird für jeden zu iterierenden Wert einmal ausgegeben. Wird über eine Wertliste iteriert, so ist der aktuelle Wert als TagInfo "currentvalue" verfügbar (was per tml:taginfo ausgelesen werden kann). Wird über Contentdokumente z.B. eines Navigators oder einer Kollektion iteriert, so wird das aktuelle Contentdokument zum Kontext des momentanen Durchlaufs.
Abgeleitet von:
<tml:[Alle Tags]>
Attribute:
Vererbte WebTML-Attributes sind ausgeblendet -> Anzeigen
Name Wert(e) Verwendung
count 1...n Bestimmt bei type="loop" die Anzahl der auszuführenden Iterationen
currentvalue Variable Bei type="itemvalue", type="loop" und type="tagresult" werden die jeweils aktuellen Werte der Schleife in die hier spezifizierte Variable geschrieben.
filllastpage true|false|t|f|1|0 Controls, if the last page of a foreach-loop will be filled up with the last documents of the previous page, if the remaining documents are fewer than the pagesize. This only effects foreach loops with set pagesize. Defaults to "true".
item item/variable Bestimmt bei type="itemvalue" den Namen des Items, über dessen Einzelwerte iteriert werden soll.
onlypublished true|false Bestimmt ob nur publizierte Dokumente in der Iteration berücksichtigt werden sollen.
pagesize 1...n Beschränkt die Anzahl der durchzuführenden Iterationen auf n. Per tml:url können Links erstellt werden, welche auf weitere "Seiten" der Iteration blättern. Dabei ist das Konditions-Attribut hasNextPage bzw. hasPreviousPage sinnvoll, welches als Referenz diese foreach-Tag annimmt.
sortexpression expression Sortiert die Ausgabe der Iteration. Bei Wertlisten wird einfach nach den nativen Sortierung der Werte sortiert. sortExpression ist nur bei der Iteration über Content-Dokumente zugelassen. Hier hat man die Möglichkeit einen Ausdruck als TMLScript anzugeben, nach dessen Ergebnis pro Contentdokument sortiert wird.
sortitem item/variable Wird über Inhaltsdokumente iteriert, kann mit sortitem ein Feld angegeben werden über dessen Werte sortiert wird. Dieses Attribut kann alternativ zu sortexpression oder sortmeta verwendet werden.
sortlanguage tmlscript|native Bestimmt die - in Attribut sortexpression verwendete - Ausdruckssprache.
sortmeta Meta-Feld Wird über Inhaltsdokumente iteriert, kann mit sortmeta ein Meta-Feld angegeben werden über dessen Werte sortiert wird. Dieses Attribut kann alternativ zu sortexpression oder sortitem verwendet werden.
sortorder ascending|descending Sortiert die Ausgabe der Iteration. Bei Wertlisten wird einfach nach den nativen Sortierung der Werte sortiert. sortExpression ist nur bei der Iteration über Content-Dokumente zugelassen. Hier hat man die Möglichkeit einen Ausdruck als TMLScript anzugeben, nach dessen Ergebnis pro Contentdokument sortiert wird.
sourcetag Tag-ID Bestimmt bei type="content" den Quell-Tag, welcher die Inhaltsdokumente für die Iteration liefert.
type="content" content Iterieren über die ermittelten Contentdokumente eines Navigators oder einer Kollektion. Das Attribut sourcetag identifiziert den Navigator oder die Kollektion, welche die Dokumente zur Verfügung stellen. Im Innern einer Kollektion ist diese Referenzierung nicht notwendig.
type="itemvalue" itemvalue Iteriert über die Werte eines Mehrfachwert-Items. In currentvalue kann eine Variable angegeben werden, in welche der jeweils aktuelle Wert geschrieben wird.
type="level" level Wie "loop", nur dass die Anzahl der Iterationen dem Kinds-Level des aktuellen Content-Dokumentes entspricht.
type="loop" loop Iteriert eine als count-Attribut spezifizierte Anzahl. Als "currentvalue" ist die Zahl der aktuellen Iteration ermittelbar.
type="tagresult" tagresult Iteriert über die einzelnen Werte eines Tag-Ergebnisses. Dies können die Ergebnisse der Iterationsdurchläufe eines anderen Tags sein.
xplanguage native | tmlscript Bestimmt die - in Attribut sortexpression verwendete - Ausdruckssprache.

Tag-Infos :
currentpage: Die Nummer der aktuell angezeigten Seite
pages: Gesamtanzahl an darstellbaren Seiten
currentvalue: Der aktuelle Wert der Iteration (i.e. bei type="itemvalue|tagresult|level" der/die aktuelle Itemwert/Wert im Tagergebnis/Levelzahl
haspreviouspage: Boolean-Objekt, anzeigend ob eine vorherige Seite vorhanden ist (nicht zur direkten Benutzung gedacht - Stattdessen <tml:if haspreviouspage...>)
hasnextpage: Boolean-Objekt, anzeigend ob eine weitere Seite vorhanden ist (nicht zur direkten Benutzung gedacht - Stattdessen <tml:if hasnextpage...>)
startindex: Index des ersten auf der aktuellen Seite dargestellten Wertes
endindex: Index des letzten auf der aktuellen Seite dargestellten Wertes
count: Gesamtanzahl darzustellender Werte
iteration: die aktuelle Nummer der Iteration.

Beispiele:

<tml:foreach type="loop" count="26" currentvalue="c">

</tml:foreach>

<tml:collection> </tml:collection>


<< ajax count >>