The create* and delete* methods on the table allow authors to construct and
modify tables. HTML 4.0 specifies that only one of each of the
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).
createCaption
public HTMLElement createCaption()
Create a new table caption object or return an existing one.
- A
CAPTION
element.
createTFoot
public HTMLElement createTFoot()
Create a table footer row or return an existing one.
- A footer element (
TFOOT
).
createTHead
public HTMLElement createTHead()
Create a table header row or return an existing one.
- A new table header element (
THEAD
).
deleteCaption
public void deleteCaption()
Delete the table caption, if one exists.
deleteRow
public void deleteRow(int index)
throws DOMException
Delete a table row.
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.
deleteTFoot
public void deleteTFoot()
Delete the footer from the table, if one exists.
deleteTHead
public void deleteTHead()
Delete the header from the table, if one exists.
getAlign
public String getAlign()
Specifies the table's position with respect to the rest of the
document. See the align attribute definition in HTML 4.0. This
attribute is deprecated in HTML 4.0.
getBgColor
public String getBgColor()
Cell background color. See the bgcolor attribute definition in HTML
4.0. This attribute is deprecated in HTML 4.0.
getBorder
public String getBorder()
The width of the border around the table. See the border attribute
definition in HTML 4.0.
getCellPadding
public String getCellPadding()
Specifies the horizontal and vertical space between cell content and
cell borders. See the cellpadding attribute definition in HTML 4.0.
getCellSpacing
public String getCellSpacing()
Specifies the horizontal and vertical separation between cells. See the
cellspacing attribute definition in HTML 4.0.
getFrame
public String getFrame()
Specifies which external table borders to render. See the frame
attribute definition in HTML 4.0.
getRows
public HTMLCollection getRows()
Returns a collection of all the rows in the table, including all in
THEAD
, TFOOT
, all TBODY
elements.
getRules
public String getRules()
Specifies which internal table borders to render. See the rules
attribute definition in HTML 4.0.
getSummary
public String getSummary()
Description about the purpose or structure of a table. See the summary
attribute definition in HTML 4.0.
getTBodies
public HTMLCollection getTBodies()
Returns a collection of the defined table bodies.
getWidth
public String getWidth()
Specifies the desired table width. See the width attribute definition
in HTML 4.0.
insertRow
public HTMLElement insertRow(int index)
throws DOMException
Insert a new empty row in the table. The new row is inserted
immediately before and in the same section as the current
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.
- The newly created row.
DOMException
- INDEX_SIZE_ERR: Raised if the specified index is greater than the
number of rows or if the index is negative.
setAlign
public void setAlign(String align)
setBgColor
public void setBgColor(String bgColor)
setBorder
public void setBorder(String border)
setCellPadding
public void setCellPadding(String cellPadding)
setCellSpacing
public void setCellSpacing(String cellSpacing)
setFrame
public void setFrame(String frame)
setRules
public void setRules(String rules)
setSummary
public void setSummary(String summary)
setWidth
public void setWidth(String width)