public interface HTMLTableElement extends HTMLElement
CAPTION , THEAD , and TFOOT
 elements may exist in a table. Therefore, if one exists, and the
 createTHead() or createTFoot() method is called, the method returns the
 existing THead or TFoot element. See the  TABLE element definition in HTML
 4.0.
 See also the Document Object Model (DOM) Level 2 Specification.
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE| Modifier and Type | Method and Description | 
|---|---|
| HTMLElement | createCaption()Create a new table caption object or return an existing one. | 
| HTMLElement | createTFoot()Create a table footer row or return an existing one. | 
| HTMLElement | createTHead()Create a table header row or return an existing one. | 
| void | deleteCaption()Delete the table caption, if one exists. | 
| void | deleteRow(int index)Delete a table row. | 
| void | deleteTFoot()Delete the footer from the table, if one exists. | 
| void | deleteTHead()Delete the header from the table, if one exists. | 
| String | getAlign()Specifies the table's position with respect to the rest of the
 document. | 
| String | getBgColor()Cell background color. | 
| String | getBorder()The width of the border around the table. | 
| HTMLTableCaptionElement | getCaption()Returns the table's  CAPTION, or void if none exists. | 
| String | getCellPadding()Specifies the horizontal and vertical space between cell content and
 cell borders. | 
| String | getCellSpacing()Specifies the horizontal and vertical separation between cells. | 
| String | getFrame()Specifies which external table borders to render. | 
| HTMLCollection | getRows()Returns a collection of all the rows in the table, including all in
  THEAD,TFOOT, allTBODYelements. | 
| String | getRules()Specifies which internal table borders to render. | 
| String | getSummary()Description about the purpose or structure of a table. | 
| HTMLCollection | getTBodies()Returns a collection of the defined table bodies. | 
| HTMLTableSectionElement | getTFoot()Returns the table's  TFOOT, ornullif none
 exists. | 
| HTMLTableSectionElement | getTHead()Returns the table's  THEAD, ornullif none
 exists. | 
| String | getWidth()Specifies the desired table width. | 
| HTMLElement | insertRow(int index)Insert a new empty row in the table. | 
| void | setAlign(String align) | 
| void | setBgColor(String bgColor) | 
| void | setBorder(String border) | 
| void | setCaption(HTMLTableCaptionElement caption) | 
| void | setCellPadding(String cellPadding) | 
| void | setCellSpacing(String cellSpacing) | 
| void | setFrame(String frame) | 
| void | setRules(String rules) | 
| void | setSummary(String summary) | 
| void | setTFoot(HTMLTableSectionElement tFoot) | 
| void | setTHead(HTMLTableSectionElement tHead) | 
| void | setWidth(String width) | 
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitlegetAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNSappendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserDataHTMLTableCaptionElement getCaption()
CAPTION , or void if none exists.void setCaption(HTMLTableCaptionElement caption)
HTMLTableSectionElement getTHead()
THEAD , or null if none
 exists.void setTHead(HTMLTableSectionElement tHead)
HTMLTableSectionElement getTFoot()
TFOOT , or null if none
 exists.void setTFoot(HTMLTableSectionElement tFoot)
HTMLCollection getRows()
THEAD , TFOOT , all TBODY
 elements.HTMLCollection getTBodies()
String getAlign()
void setAlign(String align)
String getBgColor()
void setBgColor(String bgColor)
String getBorder()
void setBorder(String border)
String getCellPadding()
void setCellPadding(String cellPadding)
String getCellSpacing()
void setCellSpacing(String cellSpacing)
String getFrame()
void setFrame(String frame)
String getRules()
void setRules(String rules)
String getSummary()
void setSummary(String summary)
String getWidth()
void setWidth(String width)
HTMLElement createTHead()
THEAD ).void deleteTHead()
HTMLElement createTFoot()
TFOOT ).void deleteTFoot()
HTMLElement createCaption()
CAPTION element.void deleteCaption()
HTMLElement insertRow(int index) throws DOMException
index th row in the table. If index is equal
 to the number of rows, the new row is appended. In addition, when the
 table is empty the row is inserted into a TBODY which is
 created and inserted into the table. Note. A table row cannot be empty
 according to HTML 4.0 Recommendation.index - The row number where to insert a new row. This index
   starts from 0 and is relative to all the rows contained inside the
   table, regardless of section parentage.DOMException - INDEX_SIZE_ERR: Raised if the specified index is greater than the
   number of rows or if the index is negative.void deleteRow(int index)
        throws DOMException
index - The index of the row to be deleted. This index starts
   from 0 and is relative to all the rows contained inside the table,
   regardless of section parentage.DOMException - INDEX_SIZE_ERR: Raised if the specified index is greater than or
   equal to the number of rows or if the index is negative. Submit a bug or feature
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
 Copyright © 2005, 2025, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.