モジュール jdk.xml.dom

パッケージ org.w3c.dom.html

インタフェースHTMLTableElement

すべてのスーパー・インタフェース:

Element, HTMLElement, Node

public interface HTMLTableElement extends HTMLElement

テーブルに対するcreate*メソッドとdelete*メソッドを使用して、テーブルを構築したり変更したりします。 HTML 4.0では、CAPTION、THEAD、TFOOTの各要素は1つのテーブル内に1つしか存在できないと規定されています。 そのため、1つ存在しているときにcreateTHead()メソッドやcreateTFoot()メソッドを呼び出すと、メソッドから既存のTHEAD要素やTFOOT要素が返されます。 HTML 4.0のTABLE要素の定義を参照してください。

「Document Object Model (DOM) Level 2 Specification」も参照してください。

導入されたバージョン:

1.4、DOMレベル2

フィールドのサマリー

インタフェースorg.w3c.dom.Nodeで宣言されているフィールド

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

メソッドのサマリー

修飾子と型	メソッド	説明
HTMLElement	createCaption()	テーブルのキャプション・オブジェクトを新しく作成するか、既存のキャプション・オブジェクトを返します。
HTMLElement	createTFoot()	テーブルのフッター行を作成するか、既存のフッター行を返します。
HTMLElement	createTHead()	テーブルのヘッダー行を作成するか、既存のヘッダー行を返します。
void	deleteCaption()	テーブル・キャプションが存在する場合は、それを削除します。
void	deleteRow(int index)	テーブルの行を削除します。
void	deleteTFoot()	テーブルにフッターが存在する場合は、それを削除します。
void	deleteTHead()	テーブルにヘッダーが存在する場合は、それを削除します。
String	getAlign()	ドキュメントのほかの部分に対するテーブルの位置を指定します。
String	getBgColor()	セルの背景色。
String	getBorder()	テーブル周囲の境界線の幅。
HTMLTableCaptionElement	getCaption()	テーブルのCAPTIONを返し、存在しない場合はvoidを返します。
String	getCellPadding()	セルの内容とセルの境界線との間の、水平方向と垂直方向の余白を指定します。
String	getCellSpacing()	セル間の水平方向と垂直方向の余白を指定します。
String	getFrame()	テーブルの外側の境界線のうちレンダリングするものを指定します。
HTMLCollection	getRows()	THEAD要素、TFOOT要素、およびすべてのTBODY要素を含む、テーブル内のすべての行のコレクションを返します。
String	getRules()	テーブルの内側の境界線のうちレンダリングするものを指定します。
String	getSummary()	テーブルの目的や構造の説明。
HTMLCollection	getTBodies()	定義済みのテーブル本体のコレクションを返します。
HTMLTableSectionElement	getTFoot()	テーブルのTFOOTを返し、存在しない場合はnullを返します。
HTMLTableSectionElement	getTHead()	テーブルのTHEADを返し、存在しない場合はnullを返します。
String	getWidth()	必要なテーブルの幅を指定します。
HTMLElement	insertRow(int index)	テーブルに、新しい空行を挿入します。
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)

インタフェースorg.w3c.dom.Elementで宣言されたメソッド

getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

インタフェースorg.w3c.dom.html.HTMLElementで宣言されたメソッド

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

インタフェース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

メソッドの詳細

getCaption

HTMLTableCaptionElement getCaption()

テーブルのCAPTIONを返し、存在しない場合はvoidを返します。

setCaption

void setCaption(HTMLTableCaptionElement caption)

getTHead

HTMLTableSectionElement getTHead()

テーブルのTHEADを返し、存在しない場合はnullを返します。

setTHead

void setTHead(HTMLTableSectionElement tHead)

getTFoot

HTMLTableSectionElement getTFoot()

テーブルのTFOOTを返し、存在しない場合はnullを返します。

setTFoot

void setTFoot(HTMLTableSectionElement tFoot)

getRows

HTMLCollection getRows()

THEAD要素、TFOOT要素、およびすべてのTBODY要素を含む、テーブル内のすべての行のコレクションを返します。

getTBodies

HTMLCollection getTBodies()

定義済みのテーブル本体のコレクションを返します。

getAlign

String getAlign()

ドキュメントのほかの部分に対するテーブルの位置を指定します。 HTML 4.0のalign属性の定義を参照してください。 この属性はHTML 4.0で非推奨です。

setAlign

void setAlign(String align)

getBgColor

String getBgColor()

セルの背景色。 HTML 4.0のbgcolor属性の定義を参照してください。 この属性はHTML 4.0で非推奨です。

setBgColor

void setBgColor(String bgColor)

getBorder

String getBorder()

テーブル周囲の境界線の幅。 HTML 4.0のborder属性の定義を参照してください。

setBorder

void setBorder(String border)

getCellPadding

String getCellPadding()

セルの内容とセルの境界線との間の、水平方向と垂直方向の余白を指定します。 HTML 4.0のcellpadding属性の定義を参照してください。

setCellPadding

void setCellPadding(String cellPadding)

getCellSpacing

String getCellSpacing()

セル間の水平方向と垂直方向の余白を指定します。 HTML 4.0のcellspacing属性の定義を参照してください。

setCellSpacing

void setCellSpacing(String cellSpacing)

getFrame

String getFrame()

テーブルの外側の境界線のうちレンダリングするものを指定します。 HTML 4.0のframe属性の定義を参照してください。

setFrame

void setFrame(String frame)

getRules

String getRules()

テーブルの内側の境界線のうちレンダリングするものを指定します。 HTML 4.0のrules属性の定義を参照してください。

setRules

void setRules(String rules)

getSummary

String getSummary()

テーブルの目的や構造の説明。 HTML 4.0のsummary属性の定義を参照してください。

setSummary

void setSummary(String summary)

getWidth

String getWidth()

必要なテーブルの幅を指定します。 HTML 4.0のwidth属性の定義を参照してください。

setWidth

void setWidth(String width)

createTHead

HTMLElement createTHead()

テーブルのヘッダー行を作成するか、既存のヘッダー行を返します。

戻り値:

新しいテーブル・ヘッダー要素(THEAD)。

deleteTHead

void deleteTHead()

テーブルにヘッダーが存在する場合は、それを削除します。

createTFoot

HTMLElement createTFoot()

テーブルのフッター行を作成するか、既存のフッター行を返します。

戻り値:

フッター要素(TFOOT)。

deleteTFoot

void deleteTFoot()

テーブルにフッターが存在する場合は、それを削除します。

createCaption

HTMLElement createCaption()

テーブルのキャプション・オブジェクトを新しく作成するか、既存のキャプション・オブジェクトを返します。

戻り値:

CAPTION要素。

deleteCaption

void deleteCaption()

テーブル・キャプションが存在する場合は、それを削除します。

insertRow

HTMLElement insertRow(int index) throws DOMException

テーブルに、新しい空行を挿入します。 テーブルの現在のindex行目の直前で同じセクションに、新しい行が挿入されます。 indexが行数と等しい場合は、新しい行が追加されます。 また、テーブルが空の場合は、作成されてテーブルに挿入されているTBODYに行が挿入されます。 ノート HTML 4.0の勧告によると、テーブルの行を空にすることはできません。

パラメータ:

index - 新しい行を挿入する行番号。 インデックスは0から始まり、セクションの系統に関係なくテーブル内部のすべての行に対する値である。

戻り値:

新規作成された行。

例外:

DOMException - INDEX_SIZE_ERR: 指定したインデックスが行数よりも大きいか、インデックスが負の値のときに発生する

deleteRow

void deleteRow(int index) throws DOMException

テーブルの行を削除します。

パラメータ:

index - 削除される行のインデックス。 インデックスは0から始まり、セクションの系統に関係なくテーブル内部のすべての行に対する値である。

例外:

DOMException - INDEX_SIZE_ERR: 指定したインデックスが行数以上か、インデックスが負の値のときに発生する。