ContextQMD
Back to Content

HTMLTableSectionElement

files/en-us/web/api/htmltablesectionelement/index.md

latest3.3 KB
Original Source

{{ APIRef("HTML DOM") }}

The HTMLTableSectionElement interface provides special properties and methods (beyond the {{domxref("HTMLElement")}} interface it also has available to it by inheritance) for manipulating the layout and presentation of sections, that is headers, footers and bodies ({{HTMLElement("thead")}}, {{HTMLElement("tfoot")}}, and {{HTMLElement("tbody")}}, respectively) in an HTML table.

{{InheritanceDiagram}}

Instance properties

Inherits properties from its parent, {{domxref("HTMLElement")}}.

  • {{domxref("HTMLTableSectionElement.align")}} {{deprecated_inline}}
    • : 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".
  • {{domxref("HTMLTableSectionElement.rows")}} {{ReadOnlyInline}}
    • : Returns a live {{domxref("HTMLCollection")}} containing the rows in the section. The HTMLCollection is live and is automatically updated when rows are added or removed.
  • {{domxref("HTMLTableSectionElement.ch")}} {{deprecated_inline}}
    • : A string containing one single character. This character is the one to align all the cells of a column on. It reflects the char and defaults 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.
  • {{domxref("HTMLTableSectionElement.chOff")}} {{deprecated_inline}}
    • : 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 by HTMLTableRowElement.ch. This property was optional and was not very well supported.
  • {{domxref("HTMLTableSectionElement.vAlign")}} {{deprecated_inline}}
    • : 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, {{domxref("HTMLElement")}}.

  • {{domxref("HTMLTableSectionElement.deleteRow()")}}
    • : Removes the row, corresponding to the index given in parameter, in the section. If the index value is -1 the last row is removed; if it smaller than -1 or greater than the amount of rows in the collection, a {{DOMxRef("DOMException")}} with the value IndexSizeError is raised.
  • {{domxref("HTMLTableSectionElement.insertRow()")}}
    • : Returns an {{DOMxRef("HTMLTableRowElement")}} representing a new row of the section. It inserts it in the rows collection immediately before the {{HTMLElement("tr")}} element at the given index position. If the index is -1, the new row is appended to the collection. If the index is smaller than -1 or greater than the number of rows in the collection, a {{DOMxRef("DOMException")}} with the value IndexSizeError is raised.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The HTML elements implementing this interface: {{HTMLElement("tfoot")}}, {{HTMLElement("thead")}}, and {{HTMLElement("tbody")}}.