Tables

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

Creating a Table

A table is a perfect format for some types of data, including statistical information. CKEditor not only lets you add and edit this common text placeholder in a quick and easy way but also offers advanced customization options.

To create a table in CKEditor, press the Table‎ button on the toolbar. The Table Properties dialog window that will open lets you set configuration options that define table size, its display properties, or other advanced properties.

The Table Properties dialog window includes two tabs that group table options:

Both tabs contain the OK and Cancel buttons that let you accept the changes or close the dialog window without performing any changes, respectively.

Once inserted into the document, a table can be edited at any time by double-clicking it or choosing the Table Properties option from the table context menu. The Table Properties dialog window will open again and you will be able to introduce changes to the table configuration options.

If you attempt to close the Table Properties dialog window without saving the changes, you will be prompted to do so:

An alert window prompting to save the changes made to the table
An alert window prompting to save the changes made to the table


You can either proceed without saving your changes by choosing OK or close the alert window with the Cancel command and save the changes.


Table Properties

The Table Properties tab is the default tab that opens after you press the Table button on the toolbar. It allows you to set the table dimensions and configure the way it will appear in the document.

Table Properties dialog window with the default tab open
Table Properties dialog window with the default tab open


Below is an overview of all Table Properties tab elements:

  • Rows – the number of rows in the table (obligatory).
  • Columns – the number of columns in the table (obligatory).
  • Width – the width of the table in pixels or percent. Changing the unit to percent lets you set the proportion of the editing area that the table will occupy.
  • Height – the height of the table in pixels.
  • Headers – the drop-down list that formats certain table cells as headers, which applies special formatting to them. You can apply header formatting to First Row, First Column or Both.
  • Border size – the thickness of the table border in pixels.
  • Alignment – the alignment of text in the table. The following options are available: Left, Center, Right.
  • Cell spacing – the space between individual cells as well as cells and table border, in pixels.
  • Cell padding – the space between the cell border and its contents, in pixels.
  • Caption – the label of the table that is displayed on top of it.
  • Summary – the summary of the table contents that is available for assistive devices like screen readers. It is a good practice to provide your tables with meaningful summary text in order to make it more accessible to users with disabilities.

Advanced

The Advanced tab lets you configure additional image options such as assign it an ID, a class, a language direction, or CSS style properties. It is meant for advanced users with knowledge of HTML and CSS and gives nearly endless possibilities as far as the presentation of the table is concerned.

Advanced tab of the Table Properties window
Advanced tab of the Table Properties window


Below is an overview of all Advanced tab elements:

  • Id – a unique identifier for a table element in the document (id attribute).
  • Language Direction – the direction of the text in the table: left to right (LTR) or right to left (RTL) (dir attribute).
  • Stylesheet Classes – a class of the table element (class attribute). Note that a table element might be assigned more than one class. If this is a case, separate class names with spaces.
  • Style – CSS style definitions (style attribute). Note that each value must end with a semi-colon and individual properties should be separated with spaces.

Working With Tables

Once inserted into the document, the table can be modified. To edit the table, either double-click it or use the right mouse button to open the table context menu.

The context menu for a table element
The context menu for a table element


To delete the whole table and its contents, use the Delete Table option.

When you choose the Table Properties option, the dialog window of the same name will appear. It allows you to change the configuration options that were set when the table was created, except the number of rows and columns which are grayed out.

Additionally the table context menu lets you modify the rows, columns or particular table cells. This method makes it possible to insert new rows, columns or cells in specified locations as well as merge and split cells.

Editing Table Rows

The table context menu lets you edit table rows. If you hover your mouse over the Row menu option, further options become available.

The context menu for a table row element
The context menu for a table row element


Below is an overview of all Row context menu option elements:

  • Insert Row Before – inserts a new row before the one that contains the cursor.
  • Insert Row After – inserts a new row after the one that contains the cursor.
  • Delete Rows &ndsh; deletes a row that contains the cursor.

Note that CKEditor makes it possible to select multiple table cells by dragging the mouse over them, so an operation like deletion may be applied to many table rows at once.

Editing Table Columns

The table context menu lets you edit table columns. If you hover your mouse over the Column menu option, further options become available.

The context menu for a table column element
The context menu for a table column element


Below is an overview of all Column context menu option elements:

  • Insert Column Before – inserts a new column before the one that contains the cursor.
  • Insert Column After – inserts a new column after the one that contains the cursor.
  • Delete Columns &ndsh; deletes a column that contains the cursor.

Note that CKEditor makes it possible to select multiple table cells by dragging the mouse over them, so an operation like deletion may be applied to many table columns at once.


Cell

The cell context menu

  • Insert Cell Before: inserts a new cell before the cell where the cursor was located.
  • Insert Cell After: inserts a new cell after the cell where the cursor was located.
  • Delete Cells: deletes a cell the cursor was by. User may also highlight more cells and delete them.
  • Merge Cells: merges cells you have highlighted into a one cell.
  • Merge Right: merges cell where the cursor was located with the right cell.
  • Merge Down: merges cell where the cursor was located with cell below.
  • Split Cell Horizontally: splits a cell in two. One cell is split into two columns.
  • Split Cell Vertically: splits a cell in two. One cell is split into two rows.
  • Cell properties: Clicking the cell properties displays a new popup window called "Cell Properties". :


CKEditor cell properties.png

  • Width: sets the cell width in pixels or in percentage of the table width.
  • Height: sets the height of the cell.
  • Word Wrap: turns on/off word wrapping.
  • Horizontal Alignment:determines the horizontal alignment of the text in a cell. Three options are available: Left, Center and Right.
  • Vertical Alignment: determines the vertical alignment of the text in a cell, which may be set to Top, Middle, Bottom or Baseline.
  • Cell Type: determines the type of cell, user may set Data cell or Header cell.
  • Rows span: extends vertical rows.
  • Columns span:extends cells on a horizontal row (left and right).
  • Background color: sets the background color of a cell. User may either select a color or type it manually.
  • Border Color: sets the color of your cells border. User may either select a color or type it manually.