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.
* Some parts of this feature may have varying levels of support.
HTMLTableElement
インターフェイスは、(継承元でもある通常の HTMLElement
オブジェクトのインターフェイスのほかに) HTML 文書内の表のレイアウトと表現を操作するための特別なプロパティやメソッドを提供します。
インスタンスプロパティ
親である HTMLElement
から継承したプロパティがあります。
HTMLTableElement.caption
-
HTMLTableCaptionElement
で、この要素の子要素のうち最初の
を表します。見つからなければnull
になります。設定する場合は、そのオブジェクトが
ではなかった場合、DOMException
がHierarchyRequestError
の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の最初の子要素として挿入され、この要素の子要素に
があれば、最初のものがツリーから取り除かれます。 HTMLTableElement.tHead
-
HTMLTableSectionElement
で、この要素の子要素のうち最初のを表します。見つからなければ
null
になります。設定する場合は、そのオブジェクトがではなかった場合、
DOMException
がHierarchyRequestError
の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の
や
を除いた最初の子要素の前に、または該当する要素がなければ最後の子要素として挿入され、この要素の子要素にがあれば、最初のものがツリーから取り除かれます。
HTMLTableElement.tFoot
HTMLTableSectionElement
で、この要素の子要素のうち最初のを表します。見つからなければ
null
になります。設定する場合は、そのオブジェクトがではなかった場合、
DOMException
がHierarchyRequestError
の名前で発生します。正しいオブジェクトが与えられた場合は、この要素の
,
,を除いた最初の子要素の前に、または該当する要素がなければ最後の子要素として挿入され、この要素の子要素に
があれば、最初のものがツリーから取り除かれます。
HTMLTableElement.rows
読取専用生きた
HTMLCollection
で、この要素のすべての行を含みます。すなわち、この要素の子であるすべての、またはこの要素の子要素である ,
,
の何れかの子要素です。
のメンバーの行が最初に、ツリー順に現れ、
のメンバーがその後に、やはりツリー順に現れます。
HTMLCollection
は生きており、HTMLTableElement
が変化するたびに自動的に更新されます。HTMLTableElement.tBodies
読取専用生きた
HTMLCollection
で、この要素のすべてのを含みます。
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
で、この要素の子要素のうち最初のを返します。見つからなかった場合は、新しいものを作成し、
や
を除く最初の要素の直前、そのような要素がなければ最後の要素として挿入します。HTMLTableElement.deleteTHead()
この要素の子要素のうち、最初の
を取り除きます。
HTMLTableElement.createTFoot()
HTMLTableSectionElement
で、この要素の子要素のうち最初のを返します。見つからなかった場合は、新しいものを作成し、最後の要素として挿入します。
HTMLTableElement.deleteTFoot()
この要素の子要素のうち最初の
を取り除きます。
HTMLTableElement.createTBody()
HTMLTableSectionElement
で、この要素の子要素である新しいを返します。これはツリー内で最後の
要素の直後に挿入しますが、そのような要素が存在しない場合は最後の要素として挿入します。
HTMLTableElement.createCaption()
HTMLElement
で、この要素の子要素のうち最初の
を返します。存在しない場合は、新しく作成してこの