HTMLTableElement
================

**`HTMLTableElement`** インターフェイスは、（継承元でもある通常の `HTMLElement` オブジェクトのインターフェイスのほかに） HTML 文書内の表のレイアウトと表現を操作するための特別なプロパティやメソッドを提供します。

EventTarget

Node

Element

HTMLElement

HTMLTableElementインスタンスプロパティ
-----------

*親である `HTMLElement` から継承したプロパティがあります。*

`HTMLTableElement.caption`

`HTMLTableCaptionElement` で、この要素の子要素のうち最初の `<caption>` を表します。見つからなければ `null` になります。設定する場合は、そのオブジェクトが `<caption>` ではなかった場合、 `DOMException` が `HierarchyRequestError` の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の最初の子要素として挿入され、この要素の子要素に `<caption>` があれば、最初のものがツリーから取り除かれます。

`HTMLTableElement.tHead`

`HTMLTableSectionElement` で、この要素の子要素のうち最初の `<thead>` を表します。見つからなければ `null` になります。設定する場合は、そのオブジェクトが `<thead>` ではなかった場合、 `DOMException` が `HierarchyRequestError` の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の `<caption>` や `<colgroup>` を除いた最初の子要素の前に、または該当する要素がなければ最後の子要素として挿入され、この要素の子要素に `<thead>` があれば、最初のものがツリーから取り除かれます。

`HTMLTableElement.tFoot`

`HTMLTableSectionElement` で、この要素の子要素のうち最初の `<tfoot>` を表します。見つからなければ `null` になります。設定する場合は、そのオブジェクトが `<tfoot>` ではなかった場合、 `DOMException` が `HierarchyRequestError` の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の `<caption>`, `<colgroup>`, `<thead>` を除いた最初の子要素の前に、または該当する要素がなければ最後の子要素として挿入され、この要素の子要素に `<tfoot>` があれば、最初のものがツリーから取り除かれます。

`HTMLTableElement.rows` 読取専用 

生きた `HTMLCollection` で、この要素のすべての行を含みます。すなわち、この要素の子であるすべての `<tr>` 、またはこの要素の子要素である `<thead>`, `<tbody>`, `<tfoot>` の何れかの子要素です。 `<thead>` のメンバーの行が最初に、ツリー順に現れ、 `<tbody>` のメンバーがその後に、やはりツリー順に現れます。 `HTMLCollection` は生きており、 `HTMLTableElement` が変化するたびに自動的に更新されます。

`HTMLTableElement.tBodies` 読取専用 

生きた `HTMLCollection` で、この要素のすべての `<tbody>` を含みます。 `HTMLCollection` は生きており、 `HTMLTableElement` が変化するたびに自動的に更新されます。

### 廃止されたプロパティ

**警告:** 以下のプロパティは廃止されました。使用は避けてください。

`HTMLTableElement.align` 
非推奨

文字列で、 `align` 属性を反映した列挙型の値が入ります。これは、周囲のコンテキストに対する要素の内容物の配置を示します。利用可能な値は `"left"`, `"right"`, `"center"` です。

`HTMLTableElement.bgColor` 
非推奨

文字列で、セルの背景色が入ります。これは廃止された `bgColor` 属性を反映します。

`HTMLTableElement.border` 
非推奨

文字列で、表の境界の幅がピクセル数で入ります。これは廃止された `border` 属性を反映します。

`HTMLTableElement.cellPadding` 
非推奨

文字列で、セルの内容とセルの境界の間の水平・垂直空間の幅がピクセル数で入ります。これは廃止された `cellpadding` 属性を反映します。

`HTMLTableElement.cellSpacing` 
非推奨

文字列で、セル間の水平・垂直の距離がピクセル数で入ります。これは廃止された `cellspacing` 属性を反映します。

`HTMLTableElement.frame` 
非推奨

文字列で、表の外部境界の種類が入ります。これは廃止された `frame` 属性を反映し、 `"void"`, `"above"`, `"below"`, `"hsides"`, `"vsides"`, `"lhs"`, `"rhs"`, `"box"`, `"border"` のうちの何れかを取ります。

`HTMLTableElement.rules` 
非推奨

文字列で、表の内部の境界の種類が入ります。これは廃止された `rules` 属性を反映し、 `"none"`, `"groups"`, `"rows"`, `"cols"`, `"all"` のうちのいずれかを取ります。

`HTMLTableElement.summary` 
非推奨

文字列で、目的の説明や表の構造が入ります。これは廃止された `summary` 属性を反映します。

`HTMLTableElement.width` 
非推奨

文字列で、表全体の推奨される幅を表すピクセル数またはパーセント値が入ります。これは廃止された `width` 属性を反映します。

インスタンスメソッド
----------

*親である `HTMLElement` から継承したプロパティがあります。*

`HTMLTableElement.createTHead()`

`HTMLTableSectionElement` で、この要素の子要素のうち最初の `<thead>` を返します。見つからなかった場合は、新しいものを作成し、 `<caption>` や `<colgroup>` を除く最初の要素の直前、そのような要素がなければ最後の要素として挿入します。

`HTMLTableElement.deleteTHead()`

この要素の子要素のうち、最初の `<thead>` を取り除きます。

`HTMLTableElement.createTFoot()`

`HTMLTableSectionElement` で、この要素の子要素のうち最初の `<tfoot>` を返します。見つからなかった場合は、新しいものを作成し、最後の要素として挿入します。

`HTMLTableElement.deleteTFoot()`

この要素の子要素のうち最初の `<tfoot>` を取り除きます。

`HTMLTableElement.createTBody()`

`HTMLTableSectionElement` で、この要素の子要素である新しい `<tbody>` を返します。これはツリー内で最後の `<tbody>` 要素の直後に挿入しますが、そのような要素が存在しない場合は最後の要素として挿入します。

`HTMLTableElement.createCaption()`

`HTMLElement` で、この要素の子要素のうち最初の `<caption>` を返します。存在しない場合は、新しく作成してこの `<table>` 要素の最初の子としてツリーに挿入します。

`HTMLTableElement.deleteCaption()`

この要素の子要素のうち最初の `<caption>` を返します。

`HTMLTableElement.insertRow()`

`HTMLTableRowElement` でこの表の新しい行を返します。この行を行の集合の中で、 `<tr>` 要素のうち、指定された `index` の位置のものの直前に挿入されます。必要に応じて `<tbody>` を生成します。 `index` が `-1` であった場合、新しい行が行の集合に追加されます。 `index` が `-1` よりも小さかったり、行の集合に含まれる行数よりも大きかったりした場合は、 `DOMException` が `IndexSizeError` の値で発生します。

`HTMLTableElement.deleteRow()`

引数で指定された `index` に対応する行を取り除きます。 `index` の値が `-1` であった場合は、最後の行を取り除きます。 `-1` より小さかったり、行の集合に含まれる行数よりも大きかったりした場合は、 `DOMException` が `IndexSizeError` の値で発生します。

仕様書
---

| Specification |
| --- |
| HTML Standard # htmltableelement |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

* このインターフェイスを実装している HTML 要素: `<table>`