Table Properties

<< Click to Display Table of Contents >>

Navigation:  Reference > Workspace, Toolbars and Dialogs > The Table Tab >

Table Properties

This dialog is displayed by clicking in a table and selecting Properties in the Table tab. It defines or changes the formatting, layout and appearance of entire tables and selected parts of tables. It is also displayed automatically when you create a new table. See Working with Tables for details on creating and using tables.

The Table Properties Tab:

The properties in this tab are applied to the entire table.

DLG_InsertTable1T

Table Size

Rows:
Columns:

If you are creating a new table these values define the total number of rows and columns in the table.

In an existing table increasing the values adds rows and columns in the last row and column and decreasing the values deletes rows and columns from the last row and column (i.e. rightmost column and bottom row).

For more precise control over adding and deleting rows and columns use the Insert and Delete functions in the Table menu.

Table ID:

This setting is optional. It assigns an ID attribute to the <table> tag that you can reference in your own HTML code.

Most users should leave this blank. Only use it if you really plan to reference your tables by ID with your own HTML and CSS code.

If you assign your own IDs to the tables used in toggles you must be very careful not to use the same ID more than once in any topic If you do your toggles will not work properly.

Layout

Table Style:

Selecting this applies the selected table style to the table. Any attributes you change after applying a style will not be under the control of the style they are like manual formatting in a paragraph formatted with a style.

Table can split to next page:

Tables can now split automatically at page boundaries for PDFs and printed manuals generated with File menu > Print User Manual.

Page breaks are possible inside table rows but not in rows containing nested tables.

Number of heading rows:

The heading rows option repeats the first x rows of the table at the top of the table when it is continued on the following page.

If you enter 0 for the heading rows the table will not have a heading.

Head row color:

The background color for the heading row

Alternating row color:

Background color for alternating table rows. The main background color is set by the Table has solid color: setting (see below). This setting defines the color for every other row.

Autosize table:

Creates a table that calculates its size on the basis of the contents of its cells. The absolute width of the table in your output will depend on how you adjust the width of the cells and the table itself and the content you put in them.

In the editor an autosized table initially occupies the full available width of the current paragraph (if the paragraph has indents the table will be narrower than the page). You can adjust column widths with the mouse after adding content (note that this locks the width of the columns).

In PDF, printed manuals and DOCX autosized tables appear exactly as the are displayed in the editor, filling the entire width of the paragraph/page.

In HTML-based output formats autosized tables are only as wide as their content. If all columns contain full paragraphs the table will be as wide as the page but if the columns only contain small amounts of text the table will be narrower than the page.

Size table to fit on page:

Creates a table that is permanently maximized to the width of the current paragraph (if the paragraph has indents the table will be narrower than the page). This is exactly the same as setting a width of 100% with the Size manually option.

Tables sized with this option always occupy the entire available width of the current paragraph or page. They can only be made narrower by increasing the left and/or right indents of the paragraph.

The same applies for tables inside other tables: If paragraph containing the table is indented the 100% value is the width of the indented paragraph, otherwise it is the width of the cell containing the table.

Size table manually:

Creates a table with a fixed width in percent or pixels, relative to the width of the current paragraph. Setting a value of 100% is exactly the same as Size table to fit on page.

Here too, percentage values are always relative to the paragraph containing the table. If the paragraph is indented the value is a percentage of the width of the indented paragraph; otherwise the value is a percentage of the page width or the table cell width, if the table is inserted inside another table.

Note that as in HTML tables, pixel values are "preferred values" rather than being  absolute. If you insert graphics or other objects that are larger than these values the cell widths will be adjusted automatically so that the objects fit, and the other cells will be made narrower accordingly.

Note that all automatic width adjustment features can only work if the width of at least one of the table's columns is dynamic (i.e. has no set width).

To set/reset click in a table column or select one or more columns. Then select Table > Lock Column Width or right-click and select Table > Lock Column Width.

Background and Borders

These settings define the background for the entire table. You can define the background color for individual cells in the Selected Cells tab.

Table is transparent:

This makes the background of the page visible through the table.

Table has solid color:

This selects an opaque background color. If you also set a color for alternating rows (see above) this color is only used for the alternating rows of the table.

Background picture:

This allows you to use a graphics file as the background for your table. See Using background graphics in the Working with Tables chapter for details.

Select Tile to repeat the background picture, Center to center it in the table.

Cell Borders

These settings work just like the formatting parameters for borders and cell spacing in HTML tables. In all settings a value of zero turns the property off (i.e. no borders).

Cell borders:

This defines the width of borders around the cells inside the table.

Border around table:

This defines the border around the edges of the table.

Border color:

This defines the color of all borders

Border style:

This defines the appearance of the border. This is easier to see than to describe – just try it out!

You can’t define different colors for individual cell borders. However, you can achieve this by inserting a second table inside your main table. See Nested tables for details.

Cell Padding and Spacing

Cell padding:

This is the space between the edge of the cell contents and the border of the cell.

Cell spacing:

This is the space between the border of one cell and the border of the next cell. This is effectively like making a broader border between the cells but it doesn't affect the width of any border lines you define between the cells.

You can only define padding and spacing for the entire table. If you need different settings for individual rows, columns or cells you can achieve this by using nested tables.

The Selected Cells tab:

The properties in this tab are applied to selected cells only. If no cells are selected the Selected Cells properties are applied to the cell in which the cursor is located.

DLG_InsertTableC

To apply these options to a single cell just click in the cell you want to format before selecting Table Properties. You don’t need to drag to select a single cell.

Cell Options

Note that adjusting the size of cells manually with the mouse automatically resets the settings configured in this section.

Preferred width:

This sets the target width of the selected cells/columns in pixels or percent. Percent values are relative to the width of the table. If this is set to 0 the automatic width is calculated as the table width divided by the number of columns, unless graphics or other objects force different widths for individual columns.

If you set the preferred width to a non-zero percent or pixel value the editor will attempt to achieve the specified value but the widths will be adjusted if it is not possible. The width of content such as graphics or other objects always has priority. If you insert an image wider than the preferred width the cell will be made wider so that the image fits, for example.

Height at least:

This is the minimum height of the cell/row. If it is 0 the height is calculated automatically on the basis of the cell contents. If it has any non-zero value the cell/row will be at least that high, and higher if necessary to accommodate the content.

Background color:

Sets a different background color for individual cells.

Vertical alignment

Top / Center:
Bottom / Default:

These options control the vertical positioning of text and other content within the selected cells. They are pretty self-explanatory.

Cell borders

Cell borders:

Set individual border options for the selected cell(s).

See also:

Working with Tables