Section 25.262. Table: a table in an HTML document

25.262. Table: a <table> in an HTML document

DOM Level 2 HTML: Node Element HTMLElement Table

25.262.1. Properties

HTMLElement caption

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

readonly HTMLCollection rows

An array (HTMLCollection) of TableRow 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 TableSection objects that represent all the <tbody> sections in this table.

TableSection tFoot

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

TableSection 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

25.262.2. 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 it has one.

insertRow( )

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

25.262.3. Description

The Table object 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 their functionality can also be duplicated with core DOM methods.

25.262.4. See Also

TableCell, TableRow, TableSection