#cell
Mit dem Systemobjekt #cell gibt es die Möglichkeit, auf Eigenschaften und Informationen einer einzelnen Zelle in einer Tabelle zurückgreifen zu können. Das Systemobjekt steht sowohl in der Funktion Table wie auch in der Formatvorlage mit dem Kürzel td zur Verfügung.
Die allgemeine Syntax lautet:
$CMS_VALUE(#cell.METHODE)$
Nachfolgend sind die einzelnen Methodenaufrufe aufgeführt:
Aufruf | Bedeutung | Rückgabedatentyp |
---|---|---|
#cell.align | Liefert zurück, welchen Wert der Redakteur für die horizontale Ausrichtung in der Zelle ausgewählt hat. Mögliche Werte sind: | String |
#cell.attr("BEZEICHNER") | Liefert zurück, welchen Wert der Redakteur für ein benutzerspezifisches Attribut in der Zelle ausgewählt bzw. eingegeben hat. Benutzerspezifische Attribute können mit dem Parameter propertyConfig in der Eingabekomponente DOMTABLE angegeben werden. | String |
#cell.bgcolor | Liefert zurück, welchen Wert der Redakteur für die Hintergrundfarbe in der Zelle ausgewählt hat. Die Hintergrundfarbe entspricht dem vordefiniertem Attribut bgcolor des Parameters propertyConfig in der Eingabekomponente DOMTABLE. | String |
#cell.col | Liefert die Spaltennummer der Zelle zurück. Die Zählung beginnt mit 0. | |
#cell.colNumber | Liefert die Spaltennummer der Zelle zurück. Die Zählung beginnt mit 1. | |
#cell.colspan | Liefert die Anzahl der horizontal verbundenen Zellen zurück. | |
#cell.firstCell | Ermittelt, ob die Zelle die erste Zelle einer Zeile ist. | Boolean |
#cell.firstRow | Ermittelt, ob sich die Zelle in der ersten Zeile der Tabelle befindet. | Boolean |
#cell.firstRowAndCell | Ermittelt, ob die Zelle die erste Zelle der Tabelle ist. | Boolean |
#cell.lastCell | Ermittelt, ob die Zelle die letzte Zelle einer Zeile ist. | Boolean |
#cell.lastRow | Ermittelt, ob sich die Zelle in der letzten Zeile der Tabelle befindet. | Boolean |
#cell.lastRowAndCell | Ermittelt, ob die Zelle die letzte Zelle der Tabelle ist. | Boolean |
#cell.remainingCols | Ermittelt die Anzahl der verbleibenden Spalten in einer Zeile inklusive der aktuellen Zelle. D.h. wenn eine Zeile vier Spalten umfasst und die Zelle in der Zeile ausgegeben wird, ist die Rückgabe von #cell.remainingCols 4. | |
#cell.remainingRows | Ermittelt die Anzahl der verbleibenden Zeilen, ausgehenden von der aktuellen Zeilenposition. Bei der Zählung ist die aktuelle Zeile inbegriffen. D.h. wenn die Tabelle vier Zeilen umfasst und die Zellen der ersten Zeile gerendert werden, ist die Rückgabe von #cell.remainingRows 4. | |
#cell.row | Liefert die Zeilennummer der Zelle zurück. Die Zählung beginnt mit 0. | |
#cell.rowNumber | Liefert die Zeilennummer der Zelle zurück. Die Zählung beginnt mit 1. | |
#cell.rowspan | Liefert die Anzahl der vertikal verbundenen Zellen zurück. | |
#cell.valign | Liefert zurück, welchen Wert der Redakteur für die vertikale Ausrichtung in der Zelle ausgewählt hat. Mögliche Werte sind: | String |
Beispiele zu #cell
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: Tabellenzelle mit Verschmelzung, Hintergrundfarbe und Ausrichtung
<td
$CMS_IF(#cell.rowspan > 1)$
rowspan="$CMS_VALUE(#cell.rowspan)$"
$CMS_END_IF$
$CMS_IF(#cell.colspan > 1)$
colspan="$CMS_VALUE(#cell.colspan)$"
$CMS_END_IF$
style="
$CMS_IF(!#cell.bgcolor.isEmpty)$
background-color:$CMS_VALUE(#cell.bgcolor)$;
$CMS_END_IF$
$CMS_IF(!#cell.align.isEmpty && (#cell.align != "left"))$
text-align:$CMS_VALUE(#cell.align)$;
$CMS_END_IF$
"
>
$CMS_IF(#content.isEmpty)$
$CMS_ELSE$
$CMS_VALUE(#content)$
$CMS_END_IF$
</td>
Im Beispiel wird zunächst geprüft, ob mehr als eine Zelle vertikal verbunden ist. Ist dies der Fall, so wird die Anzahl der vertikal verbundenen Zellen für HTML aufbereitet ausgegeben. Im nächsten Schritt wird geprüft, ob mehr als eine Zelle horizontal verbunden ist. Ist dies der Fall, so wird die Anzahl der horizontal verbundenen Zellen (für HTML aufbereitet) ausgegeben. Anschließend wird noch geprüft, ob die Eigenschaften für die Hintergrundfarbe und die Ausrichtung in der Zelle gesetzt sind. Abschließend wird noch geprüft, ob für die Zelle Inhalt eingegeben wurde. Ist dies der Fall, so wird der Inhalt ausgegeben, ansonsten ein Leerzeichen.
Beispielausgabe:
<td
colspan="2"
style="background-color:#220022;"
>
Ein Zelleninhalt
</td>