goog.editor.Table

Provided By	`goog.editor.Table`

Class providing high level table editing functions.

new Table( `node` )

Parameters

`node`	`(Element\|null)`
	Element that is a table or descendant of a table.

VIEW SOURCE

Instance Methods

Creates an empty TD element and fill it with some empty content so it will show up with borders even in IE pre-7 or if empty-cells is set to 'hide'

Parameters

None.

Returns

Element

a new TD element.

VIEW SOURCE

Inserts a cell element at the given position. The colIndex is the logical column index, not the position in the dom. This takes into consideration that cells in a given logical row may actually be children of a previous DOM row that have used rowSpan to extend into the row.

Parameters

`td`	`(Element\|null)`
	The new cell element to insert.
`rowIndex`	`number`
	Row in which to insert the element.
`colIndex`	`number`
	Column in which to insert the element.

VIEW SOURCE

Inserts a new column in the table. The column will be created by inserting new TD elements in each row, or extending the colspan of existing TD elements.

Parameters

`opt_colIndex`	`number=`
	Index at which to insert the column. If this is omitted the column will be appended to the right side of the table.

Returns

Array<(Element|null)>

Array of new cell elements that were created to populate the new column.

VIEW SOURCE

Inserts a new row in the table. The row will be populated with new cells, and existing rowspanned cells that overlap the new row will be extended.

Parameters

`opt_rowIndex`	`number=`
	Index at which to insert the row. If this is omitted the row will be appended to the end of the table.

Returns

Element

The new row.

VIEW SOURCE

Merges multiple cells into a single cell, and sets the rowSpan and colSpan attributes of the cell to take up the same space as the original cells.

Parameters

`startRowIndex`	`number`
	Top coordinate of the cells to merge.
`startColIndex`	`number`
	Left coordinate of the cells to merge.
`endRowIndex`	`number`
	Bottom coordinate of the cells to merge.
`endColIndex`	`number`
	Right coordinate of the cells to merge.

Returns

boolean

Whether or not the merge was possible. If the cells in the supplied coordinates can't be merged this will return false.

VIEW SOURCE

Walks the dom structure of this object's table element and populates this.rows with goog.editor.TableRow objects. This is done initially to populate the internal data structures, and also after each time the DOM structure is modified. Currently this means that the all existing information is discarded and re-read from the DOM.

VIEW SOURCE

Removes a column from the table. This is done by removing cell elements, or shrinking the colspan of elements that span multiple columns.

Parameters

`colIndex`	`number`
	Index of the column to delete.

VIEW SOURCE

Removes a row from the table, removing the TR element and decrementing the rowspan of any cells in other rows that overlap the row.

Parameters

`rowIndex`	`number`
	Index of the row to delete.

VIEW SOURCE

Splits a cell with colspans or rowspans into multiple descrete cells.

Parameters

`rowIndex`	`number`
	y coordinate of the cell to split.
`colIndex`	`number`
	x coordinate of the cell to split.

Returns

Array<(Element|null)>

Array of new cell elements created by splitting the cell.

VIEW SOURCE

Instance Properties

No information.

VIEW SOURCE

No information.

VIEW SOURCE

No information.

VIEW SOURCE

Static Functions

Creates a new table element, populated with cells and formatted.

Parameters

`doc`	`(Document\|null)`
	Document in which to create the table element.
`columns`	`number`
	Number of columns in the table.
`rows`	`number`
	Number of rows in the table.
`opt_tableStyle`	`(Object\|null)=`
	Object containing borderWidth and borderColor properties, used to set the initial style of the table.

Returns

Element

a table element.

VIEW SOURCE

Returns all child elements of a TR element that are of type TD or TH.

Parameters

`tr`	`(Element\|null)`
	TR element in which to find children.

Returns

Array<(Element|null)>

array of child cell elements.

VIEW SOURCE

Static Properties

Default color for table borders.

VIEW SOURCE

Optimum size of empty cells (in pixels), if possible.

VIEW SOURCE

Maximum width for new tables.

VIEW SOURCE

goog.editor.Table

new Table( `node` )

Instance Methods

`this.`createEmptyTd() `→` `Element`

`this.`insertCellElement( `td`, `rowIndex`, `colIndex` ) `→` `void`

`this.`insertColumn( `opt_colIndex` ) `→` `Array<(Element|null)>`

`this.`insertRow( `opt_rowIndex` ) `→` `Element`

`this.`mergeCells( `startRowIndex`, `startColIndex`, `endRowIndex`, `endColIndex` ) `→` `boolean`

`this.`refresh() `→` `void`

`this.`removeColumn( `colIndex` ) `→` `void`

`this.`removeRow( `rowIndex` ) `→` `void`

`this.`splitCell( `rowIndex`, `colIndex` ) `→` `Array<(Element|null)>`

Instance Properties

`this.`dom_ `→` `goog.dom.DomHelper`

`this.`element `→` `(HTMLTableElement|null)`

`this.`rows `→` `Array<goog.editor.TableRow>`

Static Functions

Table.createDomTable( `doc`, `columns`, `rows`, `opt_tableStyle` ) `→` `Element`

Table.getChildCellElements( `tr` ) `→` `Array<(Element|null)>`

Static Properties

Table.DEFAULT_BORDER_COLOR `→` `string`

Table.OPTIMUM_EMPTY_CELL_WIDTH `→` `number`

Table.OPTIMUM_MAX_NEW_TABLE_WIDTH `→` `number`

goog.editor.Table

new Table( node )

Instance Methods

this.createEmptyTd() → Element

this.insertCellElement( td, rowIndex, colIndex ) → void

this.insertColumn( opt_colIndex ) → Array<(Element|null)>

this.insertRow( opt_rowIndex ) → Element

this.mergeCells( startRowIndex, startColIndex, endRowIndex, endColIndex ) → boolean

this.refresh() → void

this.removeColumn( colIndex ) → void

this.removeRow( rowIndex ) → void

this.splitCell( rowIndex, colIndex ) → Array<(Element|null)>

Instance Properties

this.dom_ → goog.dom.DomHelper

this.element → (HTMLTableElement|null)

this.rows → Array<goog.editor.TableRow>

Static Functions

Table.createDomTable( doc, columns, rows, opt_tableStyle ) → Element

Table.getChildCellElements( tr ) → Array<(Element|null)>

Static Properties

Table.DEFAULT_BORDER_COLOR → string

Table.OPTIMUM_EMPTY_CELL_WIDTH → number

Table.OPTIMUM_MAX_NEW_TABLE_WIDTH → number

new Table( `node` )

`this.`createEmptyTd() `→` `Element`

`this.`insertCellElement( `td`, `rowIndex`, `colIndex` ) `→` `void`

`this.`insertColumn( `opt_colIndex` ) `→` `Array<(Element|null)>`

`this.`insertRow( `opt_rowIndex` ) `→` `Element`

`this.`mergeCells( `startRowIndex`, `startColIndex`, `endRowIndex`, `endColIndex` ) `→` `boolean`

`this.`refresh() `→` `void`

`this.`removeColumn( `colIndex` ) `→` `void`

`this.`removeRow( `rowIndex` ) `→` `void`

`this.`splitCell( `rowIndex`, `colIndex` ) `→` `Array<(Element|null)>`

`this.`dom_ `→` `goog.dom.DomHelper`

`this.`element `→` `(HTMLTableElement|null)`

`this.`rows `→` `Array<goog.editor.TableRow>`

Table.createDomTable( `doc`, `columns`, `rows`, `opt_tableStyle` ) `→` `Element`

Table.getChildCellElements( `tr` ) `→` `Array<(Element|null)>`

Table.DEFAULT_BORDER_COLOR `→` `string`

Table.OPTIMUM_EMPTY_CELL_WIDTH `→` `number`

Table.OPTIMUM_MAX_NEW_TABLE_WIDTH `→` `number`