Movatterモバイル変換


[0]ホーム

URL:


MDN Web Docs

HTMLTableElement

BaselineWidely available *

TheHTMLTableElement interface provides special properties and methods (beyond the regularHTMLElement object interface it also has available to it by inheritance) for manipulating the layout and presentation of tables in an HTML document.

EventTarget Node Element HTMLElement HTMLTableElement

Instance properties

Inherits properties from its parent,HTMLElement.

HTMLTableElement.caption

AHTMLTableCaptionElement representing the first<caption> that is a child of the element, ornull if none is found. When set, if the object doesn't represent a<caption>, aDOMException with theHierarchyRequestError name is thrown. If a correct object is given, it is inserted in the tree as the first child of this element and the first<caption> that is a child of this element is removed from the tree, if any.

HTMLTableElement.tHead

AHTMLTableSectionElement representing the first<thead> that is a child of the element, ornull if none is found. When set, if the object doesn't represent a<thead>, aDOMException with theHierarchyRequestError name is thrown. If a correct object is given, it is inserted in the tree immediately before the first element that is neither a<caption>, nor a<colgroup>, or as the last child if there is no such element, and the first<thead> that is a child of this element is removed from the tree, if any.

HTMLTableElement.tFoot

AHTMLTableSectionElement representing the first<tfoot> that is a child of the element, ornull if none is found. When set, if the object doesn't represent a<tfoot>, aDOMException with theHierarchyRequestError name is thrown. If a correct object is given, it is inserted in the tree immediately before the first element that is neither a<caption>, a<colgroup>, nor a<thead>, or as the last child if there is no such element, and the first<tfoot> that is a child of this element is removed from the tree, if any.

HTMLTableElement.rowsRead only

Returns a liveHTMLCollection containing all the rows of the element, that is all<tr> that are a child of the element, or a child of one of its<thead>,<tbody> and<tfoot> children. The rows members of a<thead> appear first, in tree order, and those members of a<tbody> last, also in tree order. TheHTMLCollection is live and is automatically updated when theHTMLTableElement changes.

HTMLTableElement.tBodiesRead only

Returns a liveHTMLCollection containing all the<tbody> of the element. TheHTMLCollection is live and is automatically updated when theHTMLTableElement changes.

Obsolete Properties

Warning:The following properties are obsolete. You should avoid using them.

HTMLTableElement.alignDeprecated

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

HTMLTableElement.bgColorDeprecated

A string containing the background color of the cells. It reflects the obsoletebgColor attribute.

HTMLTableElement.borderDeprecated

A string containing the width in pixels of the border of the table. It reflects the obsoleteborder attribute.

HTMLTableElement.cellPaddingDeprecated

A string containing the width in pixels of the horizontal and vertical space between cell content and cell borders. It reflects the obsoletecellpadding attribute.

HTMLTableElement.cellSpacingDeprecated

A string containing the width in pixels of the horizontal and vertical separation between cells. It reflects the obsoletecellspacing attribute.

HTMLTableElement.frameDeprecated

A string containing the type of the external borders of the table. It reflects the obsoleteframe attribute and can take one of the following values:"void","above","below","hsides","vsides","lhs","rhs","box", or"border".

HTMLTableElement.rulesDeprecated

A string containing the type of the internal borders of the table. It reflects the obsoleterules attribute and can take one of the following values:"none","groups","rows","cols", or"all".

HTMLTableElement.summaryDeprecated

A string containing a description of the purpose or the structure of the table. It reflects the obsoletesummary attribute.

HTMLTableElement.widthDeprecated

A string containing the length in pixels or in percentage of the desired width of the entire table. It reflects the obsoletewidth attribute.

Instance methods

Inherits methods from its parent,HTMLElement.

HTMLTableElement.createTHead()

Returns anHTMLTableSectionElement representing the first<thead> that is a child of the element. If none is found, a new one is created and inserted in the tree immediately before the first element that is neither a<caption>, nor a<colgroup>, or as the last child if there is no such element.

HTMLTableElement.deleteTHead()

Removes the first<thead> that is a child of the element.

HTMLTableElement.createTFoot()

Returns anHTMLTableSectionElement representing the first<tfoot> that is a child of the element. If none is found, a new one is created and inserted in the tree as the last child.

HTMLTableElement.deleteTFoot()

Removes the first<tfoot> that is a child of the element.

HTMLTableElement.createTBody()

Returns aHTMLTableSectionElement representing a new<tbody> that is a child of the element. It is inserted in the tree after the last element that is a<tbody>, or as the last child if there is no such element.

HTMLTableElement.createCaption()

Returns anHTMLElement representing the first<caption> that is a child of the element. If none is found, a new one is created and inserted in the tree as the first child of the<table> element.

HTMLTableElement.deleteCaption()

Removes the first<caption> that is a child of the element.

HTMLTableElement.insertRow()

Returns anHTMLTableRowElement representing a new row of the table. It inserts it in the rows collection immediately before the<tr> element at the givenindex position. If necessary a<tbody> is created. 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.

HTMLTableElement.deleteRow()

Removes the row corresponding to theindex given in parameter. If theindex value is-1 the last row is removed; if it is smaller than-1 or greater than the amount of rows in the collection, aDOMException with the valueIndexSizeError is raised.

Specifications

Specification
HTML
# htmltableelement

Browser compatibility

See also

  • The HTML element implementing this interface:<table>.

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp