モジュール 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を返します。

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