Table extension - SuperDoc

Create structured data with full Word table compatibility. Professional tables with merge/split capabilities, preserving all formatting through Word import/export.

OOXML Structure

<w:tbl>
  <w:tblPr>
    <w:tblBorders>
      <w:top w:val="single" w:sz="4"/>
      <w:left w:val="single" w:sz="4"/>
      <w:bottom w:val="single" w:sz="4"/>
      <w:right w:val="single" w:sz="4"/>
      <w:insideH w:val="single" w:sz="4"/>
      <w:insideV w:val="single" w:sz="4"/>
    </w:tblBorders>
  </w:tblPr>
  <w:tr>
    <w:tc>
      <w:tcPr>
        <w:tcW w:w="2880" w:type="dxa"/>
      </w:tcPr>
      <w:p><w:r><w:t>Cell content</w:t></w:r></w:p>
    </w:tc>
  </w:tr>
</w:tbl>

Use Case

Financial reports - Quarterly data with totals
Comparison matrices - Feature/pricing tables
Schedules - Time-based planning with merged headers
Data organization - Structured content that needs alignment
Complex layouts - Merged cells for sophisticated designs

Options

Configure the extension behavior:

htmlAttributes

Object

default:"{'aria-label':'Table node'}"

Default HTML attributes for all tables

resizable

boolean

default:"true"

Enable column resizing functionality

handleWidth

number

default:"5"

Width of resize handles in pixels

cellMinWidth

number

default:"10"

Minimum cell width constraint in pixels

lastColumnResizable

boolean

default:"true"

Allow resizing of the last column

allowTableNodeSelection

boolean

default:"false"

Enable selecting the entire table node

Attributes

Node attributes that can be set and retrieved:

tableIndent

TableIndent

Table indentation configuration

borders

any

required

Border styling for this table

borderCollapse

string

default:"collapse"

CSS border-collapse property

justification

string

Table alignment (‘left’, ‘center’, ‘right’)

tableCellSpacing

number

Cell spacing in pixels for this table

Commands

`insertTable`

Insert a new table into the document Example:

editor.commands.insertTable()
editor.commands.insertTable({ rows: 3, cols: 3, withHeaderRow: true })

Parameters:

config

TableConfig

required

Table configuration options

`deleteTable`

Delete the entire table containing the cursor Example:

editor.commands.deleteTable()

`addColumnBefore`

Add a column before the current column

Preserves cell attributes from current column

Example:

editor.commands.addColumnBefore()

`addColumnAfter`

Add a column after the current column

Preserves cell attributes from current column

Example:

editor.commands.addColumnAfter()

Returns: Function Command

`deleteColumn`

Delete the column containing the cursor Example:

editor.commands.deleteColumn()

Returns: Function Command

`addRowBefore`

Add a row before the current row

Preserves cell attributes from current row

Example:

editor.commands.addRowBefore()

Returns: Function Command

`addRowAfter`

Add a row after the current row

Preserves cell attributes from current row

Example:

editor.commands.addRowAfter()

Returns: Function Command

`deleteRow`

Delete the row containing the cursor Example:

editor.commands.deleteRow()

Returns: Function Command

`mergeCells`

Merge selected cells into one

Content from all cells is preserved

Example:

editor.commands.mergeCells()

Returns: Function Command

`splitCell`

Split a merged cell back into individual cells Example:

editor.commands.splitCell()

Returns: Function Command - true if split, false if position invalid

`splitSingleCell`

Split a single unmerged cell into two cells horizontally

Different from splitCell which splits merged cells back to original cells

Example:

editor.commands.splitSingleCell()

Returns: Function Command - true if split, false if position invalid

`mergeOrSplit`

Toggle between merge and split cells based on selection

Merges if multiple cells selected, splits if merged cell selected

Example:

editor.commands.mergeOrSplit()

Returns: Function Command

`toggleHeaderColumn`

Toggle the first column as header column Example:

editor.commands.toggleHeaderColumn()

Returns: Function Command

`toggleHeaderRow`

Toggle the first row as header row Example:

editor.commands.toggleHeaderRow()

Returns: Function Command

`toggleHeaderCell`

Toggle current cell as header cell Example:

editor.commands.toggleHeaderCell()

Returns: Function Command

`setCellAttr`

Set an attribute on selected cells Example:

editor.commands.setCellAttr('background', { color: 'ff0000' })
setCellAttr('verticalAlign', 'middle')

Parameters:

name

string

required

Attribute name

value

any

required

Attribute value

Returns: Function Command

`goToNextCell`

Navigate to the next cell (Tab behavior) Example:

editor.commands.goToNextCell()

Returns: Function Command

`goToPreviousCell`

Navigate to the previous cell (Shift+Tab behavior) Example:

editor.commands.goToPreviousCell()

Returns: Function Command

`fixTables`

Fix table structure inconsistencies

Repairs malformed tables and normalizes structure

Example:

editor.commands.fixTables()

Returns: Function Command

`setCellSelection`

Set cell selection programmatically Example:

editor.commands.setCellSelection({ anchorCell: 10, headCell: 15 })

Parameters:

pos

CellSelectionPosition

required

Cell selection coordinates

Returns: Function Command

`setCellBackground`

Set background color for selected cells Example:

editor.commands.setCellBackground('#ff0000')
editor.commands.setCellBackground('ff0000')

Parameters:

value

string

required

Color value (hex with or without #)

`deleteCellAndTableBorders`

Remove all borders from table and its cells

Sets all border sizes to 0

Example:

editor.commands.deleteCellAndTableBorders()

Returns: Function Command

Keyboard Shortcuts

Command	Shortcut	Description
goToNextCell/addRowAfter()	`Tab`	Navigate to next cell or add row
goToPreviousCell()	`Shift-Tab`	Navigate to previous cell
deleteTableWhenSelected()	`Backspace`	Delete table when all cells selected
deleteTableWhenSelected()	`Delete`	Delete table when all cells selected

Types

`ThemeColor`

Theme color options

`ShadingPattern`

Shading pattern options

`ShadingProperties`

Shading properties

Show Properties

color

string | any

Shading color (hex without # or “auto” for automatic)

fill

string | any

Shading fill color (hex without # or “auto” for automatic)

themeColor

ThemeColor

Theme color name

themeFill

ThemeColor

Theme fill name

themeFillShade

string

Theme fill shade (0-255 in hex format without #)

themeFillTint

string

Theme fill tint (0-255 in hex format without #)

themeShade

string

Theme shade (0-255 in hex format without #)

themeTint

string

Theme tint (0-255 in hex format without #)

val

ShadingPattern

Shading pattern

`TableMeasurement`

Table width options

Show Properties

value

number

required

Width value in twips

type

any | any | any

Table width type (dxa=twips, pct=percentage, auto=automatic)

`TableLook`

Table look options

Show Properties

firstColumn

boolean

Specifies that the first column conditional formatting should be applied

firstRow

boolean

Specifies that the first row conditional formatting should be applied

lastColumn

boolean

Specifies that the last column conditional formatting should be applied

lastRow

boolean

Specifies that the last row conditional formatting should be applied

noHBand

boolean

Specifies that no horizontal banding conditional formatting should be applied

noVBand

boolean

Specifies that no vertical banding conditional formatting should be applied

`FloatingTableProperties`

Floating table properties

Show Properties

leftFromText

number

Specifies the minimum distance in twips which shall be maintained between the current floating table and the edge of text in the paragraph which is to the left of this floating table.

rightFromText

number

Specifies the minimum distance in twips which shall be maintained between the current floating table and the edge of text in the paragraph which is to the right of this floating table.

topFromText

number

Specifies the minimum distance in twips which shall be maintained between the current floating table and the bottom edge of text in the paragraph which is above this floating table.

bottomFromText

number

Specifies the minimum distance in twips which shall be maintained between the current floating table and the top edge of text in the paragraph which is below this floating table.

tblpX

number

Specifies and absolute horizontal position for the floating table. The position is measured from the horizontal anchor point (horzAnchor) in twips.

tblpY

number

Specifies and absolute vertical position for the floating table. The position is measured from the vertical anchor point (vertAnchor) in twips.

horzAnchor

any | any | any

Horizontal anchor point for tblpX

vertAnchor

any | any | any

Vertical anchor point for tblpY

tblpXSpec

any | any | any | any | any

Specifies a relative horizontal position for the floating table. Supercedes tblpX if both are specified.

tblpYSpec

any | any | any | any | any | any

Specifies a relative vertical position for the floating table. Supercedes tblpY if both are specified.

`TableBorderSpec`

Table border specification

Show Properties

val

string

Border style (e.g., ‘single’, ‘double’, ‘dashed’, etc.)

color

string

Border color (hex without #, e.g., ‘FF0000’ for red)

themeColor

ThemeColor

Theme color name

themeTint

string

Theme tint (0-255 in hex format without #)

themeShade

string

Theme shade (0-255 in hex format without #)

size

number

Border size in eighths of a point (e.g., 8 = 1pt, 16 = 2pt)

space

number

Space in points between border and text

shadow

boolean

Whether the border has a shadow

frame

boolean

Whether the border is a frame

`TableBorders`

Table borders properties

Show Properties

bottom

TableBorderSpec

Bottom border specification

end

TableBorderSpec

End (right in LTR, left in RTL) border specification

insideH

TableBorderSpec

Inside horizontal border specification

insideV

TableBorderSpec

Inside vertical border specification

left

TableBorderSpec

Left border specification

right

TableBorderSpec

Right border specification

start

TableBorderSpec

Start (left in LTR, right in RTL) border specification

top

TableBorderSpec

Top border specification

`TableBorders`

Table borders object

Show Properties

top

TableBorder

Top border configuration

right

TableBorder

Right border configuration

bottom

TableBorder

Bottom border configuration

left

TableBorder

Left border configuration

insideH

TableBorder

Inside horizontal borders

insideV

TableBorder

Inside vertical borders

`TableCellMargins`

Table cell margin properties

Show Properties

top

TableMeasurement

Top cell margin

left

TableMeasurement

Left cell margin

bottom

TableMeasurement

Bottom cell margin

start

TableMeasurement

Start cell margin (left in LTR, right in RTL)

end

TableMeasurement

End cell margin (right in LTR, left in RTL)

right

TableMeasurement

Right cell margin

`TableProperties`

Table properties

Show Properties

rightToLeft

boolean

Specifies that the cells with this table shall be visually represented in a right to left direction

justification

any | any | any | any | any

The alignment of the set of rows which are part of the current table.

shading

ShadingProperties

Shading properties for the table

caption

string

Caption text for the table

description

string

Description text for the table

tableCellSpacing

TableMeasurement

Cell spacing

tableIndent

TableMeasurement

Table indentation

tableLayout

any | any

Table layout algorithm

tableLook

TableLook

Various boolean flags that affect the rendering of the table

overlap

any | any

Specifies whether the current table should allow other floating tables to overlap its extents when the tables are displayed in a document

tableStyleId

string

Reference to table style ID

tableStyleColBandSize

number

Number of columns for which the table style is applied

tableStyleRowBandSize

number

Number of rows for which the table style is applied

tableWidth

TableMeasurement

Table width

floatingTableProperties

FloatingTableProperties

Floating table properties

borders

TableBorders

Table border configuration

`ColWidth`

Column width definition

Show Properties

col

number

required

Column width in twips

`TableGrid`

Table grid definition

Show Properties

colWidths

Array<ColWidth>

Array of column widths in twips

`TableConfig`

Table configuration options

Show Properties

rows

number

Number of rows to create

cols

number

Number of columns to create

withHeaderRow

boolean

Create first row as header row

`TableIndent`

Table indentation configuration

Show Properties

width

number

required

Indent width in pixels

type

string

Indent type

`CellSelectionPosition`

Cell selection position

Show Properties

anchorCell

number

required

Starting cell position

headCell

number

required

Ending cell position

`CurrentCellInfo`

Current cell information

Show Properties

rect

Object

required

Selected rectangle information

cell

any

required

The cell node

attrs

Object

required

Cell attributes

`CellBorder`

Cell border configuration

Show Properties

size

number

Border width in pixels

color

string

Border color

style

string

Border style

`CellBorders`

Cell borders object

Show Properties

top

CellBorder

Top border

right

CellBorder

Right border

bottom

CellBorder

Bottom border

left

CellBorder

Left border

`TableBorder`

Table border configuration

Show Properties

size

number

Border width in pixels

color

string

Border color (hex or CSS color)

style

string

Border style (solid, dashed, dotted)

`BorderOptions`

Border creation options

Show Properties

size

number

Border width in pixels

color

string

Border color (hex)

Source Code

View on GitHub →

Getting Started

Core

Modules

Extensions

Solutions

Resources

​OOXML Structure

​Use Case

​Options

​Attributes

​Commands

​insertTable

​deleteTable

​addColumnBefore

​addColumnAfter

​deleteColumn

​addRowBefore

​addRowAfter

​deleteRow

​mergeCells

​splitCell

​splitSingleCell

​mergeOrSplit

​toggleHeaderColumn

​toggleHeaderRow

​toggleHeaderCell

​setCellAttr

​goToNextCell

​goToPreviousCell

​fixTables

​setCellSelection

​setCellBackground

​deleteCellAndTableBorders

​Keyboard Shortcuts

​Types

​ThemeColor

​ShadingPattern

​ShadingProperties

​TableMeasurement

​TableLook

​FloatingTableProperties

​TableBorderSpec

​TableBorders

​TableBorders

​TableCellMargins

​TableProperties

​ColWidth

​TableGrid

​TableConfig

​TableIndent

​CellSelectionPosition

​CurrentCellInfo

​CellBorder

​CellBorders

​TableBorder

​BorderOptions

​Source Code

OOXML Structure

Use Case

Options

Attributes

Commands

`insertTable`

`deleteTable`

`addColumnBefore`

`addColumnAfter`

`deleteColumn`

`addRowBefore`

`addRowAfter`

`deleteRow`

`mergeCells`

`splitCell`

`splitSingleCell`

`mergeOrSplit`

`toggleHeaderColumn`

`toggleHeaderRow`

`toggleHeaderCell`

`setCellAttr`

`goToNextCell`

`goToPreviousCell`

`fixTables`

`setCellSelection`

`setCellBackground`

`deleteCellAndTableBorders`

Keyboard Shortcuts

Types

`ThemeColor`

`ShadingPattern`

`ShadingProperties`

`TableMeasurement`

`TableLook`

`FloatingTableProperties`

`TableBorderSpec`

`TableBorders`

`TableBorders`

`TableCellMargins`

`TableProperties`

`ColWidth`

`TableGrid`

`TableConfig`

`TableIndent`

`CellSelectionPosition`

`CurrentCellInfo`

`CellBorder`

`CellBorders`

`TableBorder`

`BorderOptions`

Source Code