{{DOMRef}}
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, in an HTML table.
Properties
Inherits properties from its parent, {{domxref("HTMLElement")}}.
- {{domxref("HTMLTableSectionElement.align")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} containing an enumerated value reflecting the {{htmlattrxref("align", "tr")}} 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("HTMLTableRowElement.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")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} containing one single chararcter. This character is the one to align all the cell of a column on. It reflects the {{htmlattrxref("char", "tr")}} 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. - {{domxref("HTMLTableSectionElement.chOff")}} {{obsolete_inline}}
-
Is a {{domxref("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. - {{domxref("HTMLTableSectionElement.vAlign")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the {{htmlattrxref("valign", "tr")}} attribute and can have one of the following values:
"top"
,"middle"
,"bottom"
, or"baseline"
.
Methods
Inherits methods from its parent, {{domxref("HTMLElement")}}.
- {{domxref("HTMLTableSectionElement.deleteRow()")}}
-
Removes the cell at the given position in the section. If the given position is greater (or equal as it starts at zero) than the amount of rows in the section, or is smaller than
0
, it raises a {{domxref("DOMException")}} with theIndexSizeError
value. - {{domxref("HTMLTableSectionElement.insertCell()")}}
-
Inserts a new cell just before the given position in the section. If the given position is not given or is
-1
, it appends the row to the end of section. If the given position is greater (or equal as it starts at zero) than the amount of rows in the section, or is smaller than-1
, it raises a {{domxref("DOMException")}} with theIndexSizeError
value.
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('HTML WHATWG', "tabular-data.html#htmltablesectionelementt", "HTMLTableSectionElement")}} | {{Spec2('HTML WHATWG')}} | No change from {{SpecName("HTML5 W3C")}}. |
{{SpecName('HTML5 W3C', "tabular-data.html#htmltablesectionelement", "HTMLTableSectionElement")}} | {{Spec2('HTML5 W3C')}} | The parameter of insertCell is now optional. |
{{SpecName('DOM2 HTML', 'html.html#ID-67417573', 'HTMLTableSectionElement')}} | {{Spec2('DOM2 HTML')}} | The methods insertRow and deleteRow can raise exceptions. |
{{SpecName('DOM1', 'level-one-html.html#ID-67417573', 'HTMLTableSectionElement')}} | {{Spec2('DOM1')}} | Initial definition. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoDesktop(1.0)}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
ch and chOff |
{{CompatUnknown}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoMobile(1.0)}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
ch and chOff |
{{CompatUnknown}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
See also
- The HTML elements implementing this interface: {{HTMLElement("tfoot")}}, {{HTMLElement("thead")}}, and {{HTMLElement("tbody")}}.