HTMLTableSectionElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

* Some parts of this feature may have varying levels of support.

TheHTMLTableSectionElement interface provides special properties and methods (beyond theHTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of sections, that is headers, footers and bodies (<thead>,<tfoot>, and<tbody>, respectively) in an HTML table.

Instance properties

Inherits properties from its parent,HTMLElement.

HTMLTableSectionElement.alignDeprecated: A string 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".
HTMLTableSectionElement.rowsRead only: Returns a liveHTMLCollection containing the rows in the section. TheHTMLCollection is live and is automatically updated when rows are added or removed.
HTMLTableSectionElement.chDeprecated: A string 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.
HTMLTableSectionElement.chOffDeprecated: A string containing an 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 byHTMLTableRowElement.ch. This property was optional and was not very well supported.
HTMLTableSectionElement.vAlignDeprecated: A string 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".

Instance methods

Inherits methods from its parent,HTMLElement.

HTMLTableSectionElement.deleteRow(): Removes the row, corresponding to theindex given in parameter, in the section. If theindex value is-1 the last row is removed; if it smaller than-1 or greater than the amount of rows in the collection, aDOMException with the valueIndexSizeError is raised.
HTMLTableSectionElement.insertRow(): Returns anHTMLTableRowElement representing a new row of the section. It inserts it in the rows collection immediately before the<tr> element at the givenindex position. If theindex is-1, the new row is appended to the collection. If theindex is smaller than-1 or greater than the number of rows in the collection, aDOMException with the valueIndexSizeError is raised.