Startseite / Vorlagenentwicklung / Vorlagensyntax / Systemobjekte / #cell

#cellVerfügbar ab FirstSpirit-Version 4.0

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.

Wichtig 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>

© 2005 - 2024 Crownpeak Technology GmbH | Alle Rechte vorbehalten. | FirstSpirit 2024.12 | Datenschutz