HTMLTableElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
HTMLTableElement
インターフェイスは、(継承元でもある通常の HTMLElement
オブジェクトのインターフェイスのほかに) HTML 文書内の表のレイアウトと表現を操作するための特別なプロパティやメソッドを提供します。
インスタンスプロパティ
親である HTMLElement
から継承したプロパティがあります。
-
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>
要素の直後に挿入しますが、そのような要素が存在しない場合は最後の要素として挿入します。 -
HTMLElement
で、この要素の子要素のうち最初の<caption>
を返します。存在しない場合は、新しく作成してこの<table>
要素の最初の子としてツリーに挿入します。 -
この要素の子要素のうち最初の
<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
関連情報
- このインターフェイスを実装している HTML 要素:
<table>