articleTabularDataCell-Objekt

Dieses Objekt bietet Zugriff auf die Werte einer einzelnen Zelle in einem Tabellarischen-Daten-Widget.

value()

Syntax: cell.value(key, fallBack = null) : object

Liefert einen vom Benutzer eingegebenen/ausgewählten Wert der Zelle.

  • key - Der Name des Werts, der gelesen werden soll. 
  • fallBack - Falls der Wert nicht gefunden wurde, kann optional beim Aufruf der Funktion ein Wert angegeben werden, der zurückgeliefert wird.

Der Rückgabewert ist kommt immer mit dem richtigen Datentyp zurück, also z.B. als boolescher Wert, ganze Zahl oder Fließkommazahl. Das kann wichtig bei der weiteren Verarbeitung im JavaScript werden, so dass Sie z.B. keinen parseInt()-Aufruf machen müssen.

valueExpanded()

Syntax: cell.valueExpanded(key, fallBack = null) : object

Verhält sich analog zur value()-Funktion mit dem Unterschied, dass etwaige im zurückgegeben Wert enthalten Skript-Aufrufe und Platzhalter bereits expandiert sind.

valueRaw()

Syntax: cell.valueRaw(key, fallBack = null) : string

Verhält sich analog zur value()-Funktion mit dem Unterschied, dass der Rückgabewert immer als Zeichenfolge zurückgegeben wird und der Datentyp nicht geändert wird.

Es werden also z.B. auch boolesche Werte und Zahlen immer als Zeichenfolge zurückgegeben.