org.w3c.dom.html2
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.01.
See also the Document Object Model (DOM) Level 2 HTML Specification.
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 table bodies (including implicit ones). |
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)
Specifies the table's position with respect to the rest of the
document. |
void | setBgColor(String bgColor)
Cell background color. |
void | setBorder(String border)
The width of the border around the table. |
void | setCaption(HTMLTableCaptionElement caption)
Returns the table's CAPTION , or void if none exists. |
void | setCellPadding(String cellPadding)
Specifies the horizontal and vertical space between cell content and
cell borders. |
void | setCellSpacing(String cellSpacing)
Specifies the horizontal and vertical separation between cells. |
void | setFrame(String frame)
Specifies which external table borders to render. |
void | setRules(String rules)
Specifies which internal table borders to render. |
void | setSummary(String summary)
Description about the purpose or structure of a table. |
void | setTFoot(HTMLTableSectionElement tFoot)
Returns the table's TFOOT , or null if none
exists. |
void | setTHead(HTMLTableSectionElement tHead)
Returns the table's THEAD , or null if none
exists. |
void | setWidth(String width)
Specifies the desired table 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 the logical order (not document order) of all the rows contained inside the table. If the index is -1 the last row in the table is deleted.
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 a negative number other than -1.
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 -1 or
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.A table row cannot be
empty according to [HTML 4.01].Parameters: index The row number where to insert a new row. This index starts from 0 and is relative to the logical order (not document order) of all the rows contained inside the table.
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 a negative number other than -1.
CAPTION
, or void if none exists.Throws: DOMException
HIERARCHY_REQUEST_ERR: if the element is not a CAPTION
.
TFOOT
, or null
if none
exists.Throws: DOMException
HIERARCHY_REQUEST_ERR: if the element is not a TFOOT
.
THEAD
, or null
if none
exists.Throws: DOMException
HIERARCHY_REQUEST_ERR: if the element is not a THEAD
.