共通 DOM API

org.w3c.dom.html
インタフェース HTMLTableElement

すべてのスーパーインタフェース:
Element, HTMLElement, Node

public interface HTMLTableElement
extends HTMLElement

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

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


フィールドの概要
 
インタフェース 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.html.HTMLElement から継承されたメソッド
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle
 
インタフェース 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.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:指定したインデックスが行数以上か、インデックスが負の値のときに発生する

共通 DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2006 Sun Microsystems, Inc. 4150 Network Circle
Santa Clara, California, 95054, U.S.A. All Rights Reserved.