| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface HTMLTableElement extends HTMLElement
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 2 Specification.
Field Summary |
---|
Method Summary | |
---|---|
HTMLElement |
Create a new table caption object or return an existing one. |
HTMLElement |
Create a table footer row or return an existing one. |
HTMLElement |
Create a table header row or return an existing one. |
void |
Delete the table caption, if one exists. |
void |
deleteRow(int index) Delete a table row. |
void |
Delete the footer from the table, if one exists. |
void |
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 |
Cell background color. |
String |
The width of the border around the table. |
HTMLTableCaptionElement |
Returns the table's CAPTION , or void if none exists.
|
String |
Specifies the horizontal and vertical space between cell content and cell borders. |
String |
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 |
Description about the purpose or structure of a table. |
HTMLCollection |
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 |
|
void |
setBgColor(String bgColor) |
void |
|
void |
setCaption(HTMLTableCaptionElement caption) |
void |
setCellPadding(String cellPadding) |
void |
setCellSpacing(String cellSpacing) |
void |
|
void |
|
void |
setSummary(String summary) |
void |
setTFoot(HTMLTableSectionElement tFoot) |
void |
setTHead(HTMLTableSectionElement tHead) |
void |
|
Methods inherited from class org.w3c.dom.html.HTMLElement |
---|
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle |
Method Detail |
---|
public HTMLElement createCaption()
CAPTION
element.public HTMLElement createTFoot()
TFOOT
).public HTMLElement createTHead()
THEAD
).public void deleteCaption()
public 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.public void deleteTFoot()
public void deleteTHead()
public String getAlign()
public String getBgColor()
public String getBorder()
public HTMLTableCaptionElement getCaption()
CAPTION
, or void if none exists.
public String getCellPadding()
public String getCellSpacing()
public String getFrame()
public HTMLCollection getRows()
THEAD
, TFOOT
, all TBODY
elements.
public String getRules()
public String getSummary()
public HTMLCollection getTBodies()
public HTMLTableSectionElement getTFoot()
TFOOT
, or null
if none
exists.
public HTMLTableSectionElement getTHead()
THEAD
, or null
if none
exists.
public String getWidth()
public 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.public void setAlign(String align)
align
public void setBgColor(String bgColor)
bgColor
public void setBorder(String border)
border
public void setCaption(HTMLTableCaptionElement caption)
caption
public void setCellPadding(String cellPadding)
cellPadding
public void setCellSpacing(String cellSpacing)
cellSpacing
public void setFrame(String frame)
frame
public void setRules(String rules)
rules
public void setSummary(String summary)
summary
public void setTFoot(HTMLTableSectionElement tFoot)
tFoot
public void setTHead(HTMLTableSectionElement tHead)
tHead
public void setWidth(String width)
width
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |