モジュール 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

    • メソッドの詳細

      • getCaption

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

      • getTHead

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

      • getTFoot

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

      • 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: 指定したインデックスが行数以上か、インデックスが負の値のときに発生する。