Availability

DOM Level 1 HTML

Inherits from/Overrides

Node Element HTMLElement HTMLTableElement

Properties

HTMLTableCaptionElement caption

A reference to the <caption> element for the table, or null if there is none.

readonly HTMLCollection rows

An array (HTMLCollection) of HTMLTableRowElement objects that represent all the rows in the table. This includes all rows defined within <thead>, <tfoot>, and <tbody> tags.

readonly HTMLCollection tBodies

An array (HTMLCollection) of HTMLTableSectionElement objects that represent all the <tbody> sections in this table.

HTMLTableSectionElement tFoot

The <tfoot> element of the table, or null if there is none.

HTMLTableSectionElement tHead

The <thead> element of the table, or null if there is none.

In addition to the properties just listed, this interface defines the properties in the following table to represent the HTML attributes of the <table> element.

Property	Attribute	Description
deprecated String align	align	Horizontal alignment of table in document
deprecated String bgColor	bgcolor	Table background color
String border	border	Width of border around table
String cellPadding	cellpadding	Space between cell contents and border
String cellSpacing	cellspacing	Space between cell borders
String frame	frame	Which table borders to draw
String rules	rules	Where to draw lines within the table
String summary	summary	Summary description of table
String width	width	Table width

Methods

createCaption( )

Returns the existing <caption> for the table, or creates (and inserts) a new one if none already exists.

createTFoot( )

Returns the existing <tfoot> element for the table, or creates (and inserts) a new one if none already exists.

createTHead( )

Returns the existing <thead> element for the table, or creates (and inserts) a new one if none already exists.

deleteCaption( )

Deletes the <caption> element from the table, if it has one.

deleteRow( )

Deletes the row at the specified position in the table.

deleteTFoot( )

Deletes the <tfoot> element from the table, if it has one.

deleteTHead( )

Deletes the <thead> element from the table, if one exists.

insertRow( )

Inserts a new, empty <tr> element into the table at the specified position.

Description

This interface represents an HTML <table> element and defines a number of convenience properties and methods for querying and modifying various sections of the table. These methods and properties make it easier to work with tables, but they could also be duplicated with core DOM methods.

See Also

HTMLTableCaptionElement, HTMLTableCellElement, HTMLTableColElement, HTMLTableRowElement, HTMLTableSectionElement