TableRowElement

package js.html

extends Element › DOMElement › Node › EventTarget

Available on js

The HTMLTableRowElement interface provides special properties and methods (beyond the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of rows in an HTML table.

Documentation HTMLTableRowElement by Mozilla Contributors, licensed under CC-BY-SA 2.5.

See also:

• https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableRowElement

Variables

align:String

Is a DOMString containing an enumerated value reflecting the align attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are "left", "right", and "center".

bgColor:String

Is a DOMString containing the background color of the cells. It reflects the obsolete bgColor attribute.

read onlycells:HTMLCollection

Returns a live HTMLCollection containing the cells in the row. The HTMLCollection is live and is automatically updated when cells are added or removed.

ch:String

Is a DOMString containing one single character. This character is the one to align all the cell of a column on. It reflects the char and default to the decimal points associated with the language, e.g. '.' for English, or ',' for French. This property was optional and was not very well supported.

chOff:String

Is a DOMString containing a integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by HTMLTableRowElement.ch. This property was optional and was not very well supported.

read onlyrowIndex:Int

Returns a long value which gives the logical position of the row within the entire table. If the row is not part of a table, returns -1.

read onlysectionRowIndex:Int

Returns a long value which gives the logical position of the row within the table section it belongs to. If the row is not part of a section, returns -1.

vAlign:String

Is a DOMString representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the valign attribute and can have one of the following values: "top", "middle", "bottom", or "baseline".

Methods

deleteCell(index:Int):Void

Removes the cell at the given position in the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than 0, it raises a DOMException with the IndexSizeError value.

Throws:

null	DOMError

insertCell(index:Int = -1):Element

Inserts a new cell just before the given position in the row. If the given position is not given or is -1, it appends the cell to the row. If the given position is greater (or equal as it starts at zero) than the amount of cells in the row, or is smaller than -1, it raises a DOMException with the IndexSizeError value. Returns a reference to a HTMLTableCellElement [en-US].

Throws:

null	DOMError