Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #cell

#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: left für linksbündig (=Standard), center für zentriert und right für rechtsbündig. Die Ausrichtung entspricht dem vordefinierten Attribut align des Parameters propertyConfig in der Eingabekomponente DOMTABLE.	String (Zeichenkette)
#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 (Zeichenkette)
#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 (Zeichenkette)
#cell.col	Liefert die Spaltennummer der Zelle zurück. Die Zählung beginnt mit 0.	Integer
#cell.colNumber	Liefert die Spaltennummer der Zelle zurück. Die Zählung beginnt mit 1.	Integer
#cell.colspan	Liefert die Anzahl der horizontal verbundenen Zellen zurück.	Integer
#cell.firstCell	Ermittelt, ob die Zelle die erste Zelle einer Zeile ist.	Boolean (Boolescher Wert)
#cell.firstRow	Ermittelt, ob sich die Zelle in der ersten Zeile der Tabelle befindet.	Boolean (Boolescher Wert)
#cell.firstRowAndCell	Ermittelt, ob die Zelle die erste Zelle der Tabelle ist.	Boolean (Boolescher Wert)
#cell.lastCell	Ermittelt, ob die Zelle die letzte Zelle einer Zeile ist.	Boolean (Boolescher Wert)
#cell.lastRow	Ermittelt, ob sich die Zelle in der letzten Zeile der Tabelle befindet.	Boolean (Boolescher Wert)
#cell.lastRowAndCell	Ermittelt, ob die Zelle die letzte Zelle der Tabelle ist.	Boolean (Boolescher Wert)
#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.	Integer
#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.	Integer
#cell.row	Liefert die Zeilennummer der Zelle zurück. Die Zählung beginnt mit 0.	Integer
#cell.rowNumber	Liefert die Zeilennummer der Zelle zurück. Die Zählung beginnt mit 1.	Integer
#cell.rowspan	Liefert die Anzahl der vertikal verbundenen Zellen zurück.	Integer
#cell.valign	Liefert zurück, welchen Wert der Redakteur für die vertikale Ausrichtung in der Zelle ausgewählt hat. Mögliche Werte sind: top für oben, middle für zentriert (=Standard) und bottom für unten. Die Ausrichtung entspricht dem vordefinierten Attribut valign des Parameters propertyConfig in der Eingabekomponente DOMTABLE.	String (Zeichenkette)

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)$
    &nbsp;
  $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>

Druckversion | Seitenanfang