trueChart Help

Cell settings

A cell is a separated field inside a trueChart object that is used to show content such as charts, tables, user interface elements, etc. The following sections explains the general settings that apply for all cells.

General

In trueChart, cells are always part of a container. A container can have multiple cells, also called multiple contents. Those multiple content cells are also part of the cell settings.

Cell settings are edited in the settings editor. You can open the settings editor by clicking the cell entry in the right-click or the trueChart context menu.

The cell settings are located on the left side menu in the settings editor.

cell settings menu
Figure 1. Cell settings menu.

Multiple contents

As mentioned before, every container in trueChart can have multiple cells. There is no limitation on how many cells a container can include. However, too many cells may decrease the performance.

The active cell is defined by a condition in the menu. When multiple cells have a condition that returns true, the cell that is higher in the list gets displayed.

The typical use case for multiple cells is the ability to change the visualization on the fly.

Interactions

Interactions define the ability for the user to interact with the cells.

BI selection

Allows the user to select BI values in the BI through the extension. By default the value is active. When disabled a click on a value does not select the value in the BI.

Actions

In the Action settings, you can define triggers which will execute the actions associated with it.

cell settings custom actions
Figure 2. A cell’s action settings.

Style

Style settings are unique for every cell. By default, most cells behave in a way so they don’t interrupt the styling of the parent cells.

Horizontal

When enough space is available in the cell, the cell content can be positioned to the left, centered or to the right of the cell.

Vertical

When enough space is available in the cell, the chart can be positioned at the top, center or bottom of the cell.

Scrollbars

This setting activates or deactivates scrollbars for the cell. This can be useful when a chart just barely fits into a container and scrollbars are visible but there is nothing to scroll.

Margin, border and padding

You can define margin, padding and border for a cell. Every setting can be unique for each side of the cell or you can set them once as a uniform which effects all sides. Borders can also define a color.

cell settings border
Figure 3. Margin, padding and border settings.

Background

A cell can have a unique background. You can set an image or a color and place the background at certain positions.

When a cell is part of a grid, it has a higher priority than the underlying grid cell itself. That means, the cell in the foreground shows the background above the grid cell’s background.

cell settings background example
Figure 4. A cell with a grid and different backgrounds.