table — A formal (captioned) HTML table in a document.
- Sequence of:
- orient (enumeration)
- pgwide (enumeration)
- width (enumeration)
- border (nonNegativeInteger)
- frame (enumeration)
- rules (enumeration)
- cellspacing (enumeration)
- cellpadding (enumeration)
- example must not occur in the descendants of table
- figure must not occur in the descendants of table
- equation must not occur in the descendants of table
- informaltable must not occur in the descendants of table
- caution must not occur in the descendants of table
- important must not occur in the descendants of table
- note must not occur in the descendants of table
- tip must not occur in the descendants of table
- warning must not occur in the descendants of table
table element identifies a formal
(captioned) HTML table. DocBook allows either CALS or
HTML tables, both of which describe tables
geometrically using rows, columns, and cells.
HTML tables may include column headers and footers. To identify a
row header, use a
th in the row.
Why aren’t HTML tables in the HTML namespace?
HTML tables were introduced in DocBook V4.3 which was not in a namespace and was defined normatively with a DTD. DTDs do not support namespaces very well. The Technical Committee decided to simply add the HTML element names to DocBook. This solution simplified specification, avoided issues of namespace support in DTDs, and solved the most compelling use case: cut-and-paste of simple, text-only HTML tables into DocBook.
Strictly speaking, it would be incorrect to put these elements
in the XHTML namespace because the DocBook common attributes are
allowed on all of them and the
th elements have very different content models than
their HTML counterparts.
Specifies the width (in pixels only) of the frame around a table.
Specifies the amount of space between the border of the cell and its contents. If the value of this attribute is a pixel length, all four margins should be this distance from the contents. If the value of the attribute is a percentage length, the top and bottom margins should be equally separated from the content based on a percentage of the available vertical space, and the left and right margins should be equally separated from the content based on a percentage of the available horizontal space.
An explicit padding.
A percentage padding.
Specifies how much space the user agent should leave between the left side of the table and the left-hand side of the leftmost column, the top of the table and the top side of the topmost row, and so on for the right and bottom of the table. The attribute also specifies the amount of space to leave between cells.
An explicit spacing.
A percentage spacing.
This attribute assigns a class name or set of class names to an element. Any number of elements may be assigned the same class name or names. Multiple class names must be separated by white space characters.
Specifies style information to be used when rendering the float
Specifies which sides of the frame surrounding a table will be visible.
Enumerated values: “void”
No sides. This is the default value.
The top side only.
The bottom side only.
The top and bottom sides only.
The left-hand side only.
The right-hand side only.
The right and left sides only.
All four sides.
All four sides.
Specifies an identifying string for presentation purposes
This attribute specifies the base language of an element's attribute values and text content. The default value of this attribute is unknown.
Occurs when the pointing device button is clicked over an element.
Occurs when the pointing device button is double clicked over an element.
Occurs when a key is pressed down over an element.
Occurs when a key is pressed and released over an element.
Occurs when a key is released over an element.
Occurs when the pointing device button is pressed over an element.
Occurs when the pointing device is moved while it is over an element.
Occurs when the pointing device is moved away from an element.
Occurs when the pointing device is moved onto an element.
Occurs when the pointing device button is released over an element.
Specifies the orientation of the table
Enumerated values: “land”
90 degrees counter-clockwise from the rest of the text flow.
The same orientation as the rest of the text flow.
Indicates if the element is rendered across the column or the page
Enumerated values: “0”
The element should be rendered in the current text flow (with the flow column width).
The element should be rendered across the full text page.
Specifies which rules will appear between cells within a table. The rendering of rules is user agent dependent.
Enumerated values: “none”
No rules. This is the default value.
Rules will appear between row groups (see thead, tfoot, and tbody) and column groups (see colgroup and col) only.
Rules will appear between rows only.
Rules will appear between columns only.
Rules will appear between all rows and columns.
This attribute specifies style information for the current element.
Provides a summary of the table's purpose and structure for user agents rendering to non-visual media such as speech and Braille.
Specifies the table style
This attribute offers advisory information about the element for which it is set.
Specifies the desired width of the entire table and is intended for visual user agents. When the value is a percentage value, the value is relative to the user agent's available horizontal space. In the absence of any width specification, table width is determined by the user agent.
An explicit width.
A percentage width.
These elements contain
1 <article xmlns='http://docbook.org/ns/docbook'> 2 <title>Example table</title> 4 <table xml:id="ex.htmltable"> <caption>Sample HTML Table</caption> 6 <thead> <tr> 8 <td>Head 1</td> <td>Head 2</td> 10 </tr> </thead> 12 <tbody> <tr> 14 <td>Body 1</td> <td>Body 2</td> 16 </tr> </tbody> 18 </table> 20 </article>
|Head 1||Head 2|
|Body 1||Body 2|