table – table

Permitted contents #

an optional caption element, followed by zero or more colgroup elements, followed by an optional thead element, followed by one tfoot element, followed by zero or more tbody elements, or one or more tr elements or zero or more tbody elements, or one or more tr elements followed by an optional tfoot element

Permitted attributes #

global attributes & border

ⓘ global attributes: Any attributes permitted globally.
ⓘ border = string #: Indicates that its table element is not being used for layout purposes.

Additional constraints and admonitions #

The element table must not appear as a descendant of the caption element.
The summary attribute on the table element is obsolete. Consider describing the structure of the table in a caption element or in a figure element containing the table element; or, simplify the structue of the table so that no description is needed.
The align attribute on the table element is obsolete. Use CSS instead.
The width attribute on the table element is obsolete. Use CSS instead.
The bgcolor attribute on the table element is obsolete. Use CSS instead.
The value of the border attribute on the table element must be either “1” or the empty string. To regulate the thickness of table borders, Use CSS instead.
The cellpadding attribute on the table element is obsolete. Use CSS instead.
The cellspacing attribute on the table element is obsolete. Use CSS instead.
The frame attribute on the table element is obsolete. Use CSS instead.
The rules attribute on the table element is obsolete. Use CSS instead.

Tag omission #

A table element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements

Details #

Although in previous versions of HTML a table element was only allowed to contain a tfoot element if that tfoot occurred before any tbody or tr elements, but not after, the table element is now also alternatively allowed to contain a tfoot after any tbody or tr elements.

DOM interface #

interface HTMLTableElement : HTMLElement {
           attribute HTMLTableCaptionElement? caption;
  HTMLElement createCaption();
  void deleteCaption();
           attribute HTMLTableSectionElement? tHead;
  HTMLElement createTHead();
  void deleteTHead();
           attribute HTMLTableSectionElement? tFoot;
  HTMLElement createTFoot();
  void deleteTFoot();
  readonly attribute HTMLCollection tBodies;
  HTMLElement createTBody();
  readonly attribute HTMLCollection rows;
  HTMLElement insertRow(optional long index);
  void deleteRow(long index);
           attribute DOMString border;
};

Typical default display properties #

table {

display: table;

border-collapse: separate;

border-spacing: 2px;

border-color: gray; }

HTML: The Markup Language (an HTML language reference)

ⓘ table – table # T