org.w3c.dom.html
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 1 Specification (Second Edition).
Method Summary | |
---|---|
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 , all TBODY
elements. |
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 , or null if none
exists. |
HTMLTableSectionElement | getTHead()
Returns the table's THEAD , or null if 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) |
Returns: A CAPTION
element.
Returns: A footer element (TFOOT
).
Returns: A new table header element (THEAD
).
Parameters: 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.
Throws: 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.
CAPTION
, or void if none exists.THEAD
, TFOOT
, all TBODY
elements.TFOOT
, or null
if none
exists.THEAD
, or null
if none
exists.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.Parameters: 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.
Returns: The newly created row.
Throws: DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows or if the index is negative.