Inserting a Table
To insert a table, locate the table icon in the toolbox to the top right of the screen.
Drag the mouse arrow to select the required number of columns and rows.
The table is inserted in the editing canvas and Structure tree to the left of the canvas is populated with all the elements of the inserted table:
- table: select this element to set properties that apply to the whole table
- table-colgroup: this is a parent element for the table columns, it has no properties
- table-col: select this element to set properties for a column (the element is repeated for every column)
- table-body: select this element to set properties that apply to all cells in the table
- table-row: select this element to set properties that apply to the selected row, the element is repeated for every row in the table
- table-cell: select this element to set properties that apply to the selected cell, the element is repeated for every cell in the row.
To set table properties, select one the table element or one of its children in the Structure tree. By pressing down the Ctrl-key, you can select multiple elements of the same type (e.g. multiple table cells) at the same time. When an element is selected, you can change its properties in the properties pain on the right of the screen.
Alternatively you can select table elements directly on the canvas by just clicking them. Press down Ctrl to select multiple elements.
If you select the table element (the top element of a table in the Structure tree), then you can set properties that apply to the whole table. If you select a table row element, then you can set properties that apply to the table row, when you select a table cell, then you can set properties that apply to only the selected cell. Properties are inherited from a higher level (e.g. table) in the Structure tree and can be overridden on a lower level (e.g. table cell). The section below outlines the properties on the table level. The same properties are available on a lower level.
- Name: set a name for this table which can be used in referrals
- Data Bind: bind this table to a field in the data collection. Typically, this feature can be used to bind the table to an array in the data collection, so the full table will be repeated for every item in the array.
- If you bind a table to an array, you could also set a minimum or maximum number of repetitions.
If the table is bound to an array with 6 repeating items, and the minimum repetitions is set to 10 → this will result in 10 tables, 6 that are bound to an item in the array, and four additional ones to get to the set minimum of 10 repetitions.
If the table is bound to an array with 6 repeating items, and the maximum repetitions is set to 4 → this will result in 4 tables, bound to the first 4 items in the array.
- Text Style
- Set font, size, color and text decoration settings that will apply to all text in the table, unless overruled on a lower level.
- Set word and character spacing that will apply to all text in the table, unless overruled on a lower level.
- Paragraph Style
- Set alignment, indent and line height for all paragraphs inserted in table cells. These settings can be overruled on the row, cell or rich text element level.
- Insert page break after: use this setting to insert a page break after the table.
If you apply this setting to a table that is bound to an array, every table except the first one will start on a new page.
- Set width, height of the table.
- Set a background color for the whole table
- Set margins and paddings (padding is the distance between the table and surrounding elements - padding is the distance between the edge of the table and its inner elements)
- Set the outer borders of the table. Set weight, style color and radius of the table's outer borders.
Setting Column Width
To set table column with, select the table-col element in the Structure tree. Columns are listed in the templates reading order.
With the column selected, you can change the width of the selected column in the properties panel on the right. If no width values are specified, the available space is distributed evenly across the columns.
When you select a row, a column or a cell of a table, the contextual table menu will appear in the command bar above the editing canvas.
The table command bar contains these controls, from left to right:
- add row above;
- add row below;
- delete row;
- add column to the left;
- add column to the right;
- delete column;
- merge selected cells (requires multiple adjacent cells to be selected);
- split selected cell;
- mark as header column;
- mark as header row;
- mark as footer row;
- select row;
- select column;
- select table.