|
Common DOM API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface HTMLTableElement
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 |
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)
|
Methods inherited from interface org.w3c.dom.html.HTMLElement |
---|
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle |
Methods inherited from interface org.w3c.dom.Element |
---|
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS |
Methods inherited from interface org.w3c.dom.Node |
---|
appendChild, 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, setUserData |
Method Detail |
---|
HTMLTableCaptionElement 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.
|
Common DOM API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |