#cs
Das Systemobjekt #cs steht in Tabellenvorlagen zur Verfügung. Tabellenvorlagen können als datenquellen-basierende Absätze in einer Seite der Inhalte-Verwaltung verwendet werden. Bei der Ausgabe des Absatzes in einer Vorschau oder Generierung stellt #cs Informationen zur aktuellen datenquellen-basierenden Teilseite (vgl. auch Mehrfachseiten) und zum aktuellen Datensatz zur Verfügung. Dadurch ist es möglich, u.a. zu ermitteln, ob der aktuelle Datensatz der erste oder letzte der Teilseite ist, wie viele Datensätze dargestellt werden, usw.
Folgende Methoden können auf #cs angewendet werden:
Aufruf | Beschreibung | Rückgabedatentyp |
---|---|---|
#cs.contentLength | Ermittelt, wie viele Datensätze auf der aktuellen Teilseite der Mehrfachseite dargestellt werden. Die Zählung beginnt mit 1. | |
#cs.contentPosition | Liefert den Index der Teilseite in der Mehrfachseite zurück. Die Zählung beginnt mit 0. | |
#cs.currentRowNumber | Liefert die Nummer des aktuellen Datensatzes in der Teilseite zurück. | |
#cs.isEvenContentRow | Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite gerade ist. | Boolean |
#cs.isFirstContentRow | Ermittelt, ob der aktuelle Datensatz der erste in der Teilseite der Mehrfachseite ist. | Boolean |
#cs.isLastContentRow | Ermittelt, ob der aktuelle Datensatz der letzte in der Teilseite der Mehrfachseite ist. | Boolean |
#cs.isOddContentRow | Ermittelt, ob die Nummer des aktuellen Datensatzes in der Teilseite ungerade ist. | Boolean |
Beispiele zu #cs
Nachfolgend werden einige Beispiele zur Verwendung der Anweisung innerhalb von Vorlagen gezeigt. Die Beispiele sollen die konkrete Auswirkung der Anweisung verdeutlichen und eine Hilfe für den Vorlagenentwickler bei der Erstellung eigener Vorlagen sein.
Für die Verwendung innerhalb eines Projekts, müssen die hier gezeigten Beispiele angepasst werden! Beispielsweise müssen Variablennamen auf die spezifischen Variablennamen des Projekts geändert werden, in dem die Anweisung verwendet werden soll. |
1. Beispiel: Numerierte Ausgabe von Datensätzen
$CMS_IF(#cs.isFirstContentRow)$
<table>
$CMS_END_IF$
<tr>
<td>$CMS_VALUE(#cs.currentRowNumber + 1)$/$CMS_VALUE(#cs.contentLength)$</td>
</tr>
$CMS_IF(#cs.isLastContentRow)$
</table>
$CMS_END_IF$
Das Beispiel gibt für eine Teilseite einer Mehrfachseite aus, der wievielte Datensatz von insgesamt wie vielen Datensätzen ausgegeben wird. Zusätzlich wird beim ersten Datensatz auf der Teilseite eine öffnendes table-Tag ausgeben und beim letzten ein schließendes.
Exemplarische Ausgabe:
1/3
2/3
3/3