Common 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_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, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS
 
インタフェース org.w3c.dom.Node から継承したメソッド
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix
 

メソッドの詳細

getCaption

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


setCaption

public void setCaption(HTMLTableCaptionElement caption)

getTHead

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


setTHead

public void setTHead(HTMLTableSectionElement tHead)

getTFoot

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


setTFoot

public void setTFoot(HTMLTableSectionElement tFoot)

getRows

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


getTBodies

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


getAlign

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


setAlign

public void setAlign(String align)

getBgColor

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


setBgColor

public void setBgColor(String bgColor)

getBorder

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


setBorder

public void setBorder(String border)

getCellPadding

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


setCellPadding

public void setCellPadding(String cellPadding)

getCellSpacing

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


setCellSpacing

public void setCellSpacing(String cellSpacing)

getFrame

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


setFrame

public void setFrame(String frame)

getRules

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


setRules

public void setRules(String rules)

getSummary

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


setSummary

public void setSummary(String summary)

getWidth

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


setWidth

public void setWidth(String width)

createTHead

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

戻り値:
新しいテーブルヘッダ要素 (THEAD)

deleteTHead

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


createTFoot

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

戻り値:
フッタ要素 (TFOOT)

deleteTFoot

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


createCaption

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

戻り値:
CAPTION 要素

deleteCaption

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


insertRow

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

パラメータ:
index - 新しい行を挿入する行番号。インデックスは 0 から始まり、セクションの 系統に関係なくテーブル内部のすべての行に対する値である
戻り値:
新規作成された行
例外:
DOMException - INDEX_SIZE_ERR:指定したインデックスが行数よりも大きいか、インデックスが負の値の ときに発生する

deleteRow

public void deleteRow(int index)
               throws DOMException
テーブルの行を削除します。

パラメータ:
index - 削除される行のインデックス。インデックスは 0 から始まり、セクション の系統に関係なくテーブル内部のすべての行に対する値である
例外:
DOMException - INDEX_SIZE_ERR:指定したインデックスが行数以上か、インデックスが負の値のときに 発生する

Common DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.