Interface HTMLTableElement

継承元:

HTMLElement

プロパティ:

align, bgColor, border, caption, cellPadding, cellSpacing, frame, rows, rules, summary, tBodies, tFoot, tHead, width

メソッド:

createCaption, createTFoot, createTHead, deleteCaption, deleteRow, deleteTFoot, deleteTHead, insertRow

プロパティ:

• htmltableelementObject.align

  DOMString型

  残りの文書に対する表の配置を指定する。 HTML 4.01 の align 属性の定義 を参照。 この属性は HTML 4.01 では非推奨である。
  

• htmltableelementObject.bgColor

  DOMString型

  セルの背景色。 HTML 4.01 の bgcolor 属性の定義 を参照。 この属性は HTML 4.01 では非推奨である。
  

• htmltableelementObject.border

  DOMString型

  テーブルを囲む枠の幅。 HTML 4.01 の border 属性の定義 を参照。
  

• htmltableelementObject.caption

  HTMLTableCaptionElement型

  テーブルの CAPTION を返す。存在しない場合は何も返さない。
  

  設定時の例外:

  HIERARCHY_REQUEST_ERR / DOMException

  要素が CAPTION でない場合。

• htmltableelementObject.cellPadding

  DOMString型

  セル内容とセル枠の間の水平方向・垂直方向の余白を指定。 HTML 4.01 の cellpadding 属性の定義 を参照。
  

• htmltableelementObject.cellSpacing

  DOMString型

  セル同士間の水平方向・垂直方向の間隔を指定。 HTML 4.01 の cellspacing 属性の定義 を参照。
  

• htmltableelementObject.frame

  DOMString型

  描画するテーブルの外枠を指定。 HTML 4.01 の frame 属性の定義 を参照。
  

• htmltableelementObject.rows

  HTMLCollection型, 読取専用

  THEAD, TFOOT, 全 TBODY 要素の全てを含めたテーブル内の行全てのコレクションを返す。
  

• htmltableelementObject.rules

  DOMString型

  描画するテーブルの内枠を指定。 HTML 4.01 の rules 属性の定義 を参照。
  

• htmltableelementObject.summary

  DOMString型

  テーブルの目的あるいは構造についての説明。 HTML 4.01 の summary 属性の定義 を参照。
  

• htmltableelementObject.tBodies

  HTMLCollection型, 読取専用

  (暗示的なものを含む)テーブル本体(table bodies)のコレクションを返す。
  

• htmltableelementObject.tFoot

  HTMLTableSectionElement型

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

  設定時の例外:

  HIERARCHY_REQUEST_ERR / DOMException

  要素が TFOOT でない場合。

• htmltableelementObject.tHead

  HTMLTableSectionElement型

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

  設定時の例外:

  HIERARCHY_REQUEST_ERR / DOMException

  要素が THEAD でない場合。

• htmltableelementObject.width

  DOMString型

  希望するテーブル幅を指定。 HTML 4.01 の width 属性の定義 を参照。
  

メソッド:

• htmltableelementObject.createCaption( )

  新規テーブルキャプションオブジェクトを生成する。あるいは既存のものを返す。

  戻り値:

  HTMLElement 型。CAPTION 要素。

• htmltableelementObject.createTFoot( )

  テーブルフッタ行を生成する。または既存のものを返す。

  戻り値:

  HTMLElement 型。フッタ要素 (TFOOT)。

• htmltableelementObject.createTHead( )

  テーブルヘッダを生成する。または既存のものを返す。

  戻り値:

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

• htmltableelementObject.deleteCaption( )

  テーブルキャプションが存在すれば、それを削除する。

  戻り値:

  (無し)

• htmltableelementObject.deleteRow( index )

  テーブルの行を削除する。

  引数:

  index / long

  削除する行のインデックス。このインデックスは0から開始し、テーブル内部に含まれる全行の(文書オーダーではなく)論理オーダーに関連する[訳注: HTMLTableRowElement の rowIndex 参照]。インデックスが-1なら、テーブル内の最後の行が削除される。
  

  戻り値:

  (無し)

  例外:

  INDEX_SIZE_ERR / DOMException

  指定されたインデックスが行の総数以上である場合、または-1以外の負のインデックスである場合に発生。

• htmltableelementObject.deleteTFoot( )

  フッタがあれば、それをテーブルから削除する。

  戻り値:

  (無し)

• htmltableelementObject.deleteTHead( )

  ヘッダがあれば、それをテーブルから削除する。

  戻り値:

  (無し)

• htmltableelementObject.insertRow( index )

  テーブルに新しい空の行を挿入する。新しい行は、テーブル内の現在の index 番目の行の同じセクション内の直前に挿入される。 index が -1 であるか行数と等しい場合は、新しい行が追加される。加えて、テーブルが空である場合、 TBODY が生成されてテーブルに挿入され、行はその中に挿入される。

  Note: テーブルの行は、 [HTML 4.01] では空ではありえない。

  引数:

  index / long

  新しく挿入する行の行番号。このインデックスは0から開始し、テーブル内部に含まれる全行の(文書オーダーではなく)論理オーダーに関連する[訳注: HTMLTableRowElement の rowIndex 参照]。
  

  戻り値:

  HTMLElement 型。新しく生成された行。

  例外:

  INDEX_SIZE_ERR / DOMException

  指定されたインデックスが行の総数以上である場合、または -1 以外の負のインデックスである場合に発生。

IDL 定義:

interface HTMLTableElement : HTMLElement {
  // Modified in DOM Level 2:
           attribute HTMLTableCaptionElement caption;
                                        // raises(DOMException) on setting
  // Modified in DOM Level 2:
           attribute HTMLTableSectionElement tHead;
                                        // raises(DOMException) on setting
  // Modified in DOM Level 2:
           attribute HTMLTableSectionElement tFoot;
                                        // raises(DOMException) on setting
  readonly attribute HTMLCollection  rows;
  readonly attribute HTMLCollection  tBodies;
           attribute DOMString       align;
           attribute DOMString       bgColor;
           attribute DOMString       border;
           attribute DOMString       cellPadding;
           attribute DOMString       cellSpacing;
           attribute DOMString       frame;
           attribute DOMString       rules;
           attribute DOMString       summary;
           attribute DOMString       width;
  HTMLElement        createTHead();
  void               deleteTHead();
  HTMLElement        createTFoot();
  void               deleteTFoot();
  HTMLElement        createCaption();
  void               deleteCaption();
  // Modified in DOM Level 2:
  HTMLElement        insertRow(in long index)
                                        raises(DOMException);
  // Modified in DOM Level 2:
  void               deleteRow(in long index)
                                        raises(DOMException);
};

• Back to Document Object Model HTML
• Object Index
• Glossary
• References