HTMLTableElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

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

インスタンスプロパティ

親である 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 の値で発生します。