DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Table

The "Table" content element allows to provide data as "comma separated values (CSV)", a plain text form of storing tabular data (numbers and text). This form is often used to move tabular data between two programs that natively operate on incompatible (often proprietary and/or undocumented) formats, like Microsoft Office Excel. These programs often provide CSV as an export method.

Backend display of the fields for the Table in the General tab

The "General" table settings

Each line in the field Table content represents a row in the table. Columns are separated by a field delimiter, which can be configured with the corresponding field. Columns can be enclosed by a character, configured in the field Text enclosure. This is especially helpful when you want to have newlines within a column. By default the Field delimiter is a vertical bar "|", the Text enclosure set to none.

row 1 column 1|row 1 column 2|row 1 column 3
row 2 column 1|row 2 column 2|row 2 column 3
row 3 column 1|row 3 column 2|row 3 column 3

A Table caption can be provided as a heading for the table.

Backend display of the Appearance tab

The "Appearance" tab

Also some appearance options are available for the table. These can be found in the Appearance tab:

Columns
The maximum amount of columns. Even when more columns are defined in the Table content field, the table will only show the maximum amount of columns.
Table header position
The first row or the first column can be used as a table header.
Use table footer
The last row will be used to group the table’s footer area (which may be a summary, an addition of column values, or some call to action based on the preceding content).
Frontend rendering of two tables, one with a header position on top, the other one on the left

Frontend output, showing the different options of "Table header position"