table (db.cals.table)

table — A formal table in a document.

Synopsis

Sequence of:
- One of:
  - Sequence of:
    Interleave of:
    title
    titleabbrev?
    info? (db.titleforbidden.info)
  - info (db.titleonlyreq.info)
- Interleave of:
  - alt?
  - Zero or more of:
    Indexing inlines
    indexterm (db.indexterm.endofrange)
    indexterm (db.indexterm.singular)
    indexterm (db.indexterm.startofrange)
  - Zero or more of:
    textobject
- One of:
  - One or more of:
    mediaobject
  - One or more of:
    tgroup
- caption? (db.caption)

Attributes

Common attributes and common linking attributes.

Additional attributes:

colsep (enumeration)
- “0”
- “1”
floatstyle
frame (enumeration)
- “all”
- “bottom”
- “none”
- “sides”
- “top”
- “topbot”
label
orient (enumeration)
- “land”
- “port”
pgwide (enumeration)
- “0”
- “1”
rowheader (enumeration)
- “firstcol”
- “norowheader”
rowsep (enumeration)
- “0”
- “1”
shortentry (enumeration)
- “0”
- “1”
tabstyle
tocentry (enumeration)
- “0”
- “1”

Additional Constraints

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

Description

This table element identifies a formal table (one with a title). DocBook allows either CALS or HTML tables, both of which describe tables geometrically using rows, columns, and cells.

Tables may include column headers and footers with thead and tfoot, respectively. Use the rowheader attribute to identify row headers.

Processing expectations

Formatted as a displayed block. This element is expected to obey the semantics of the CALS Table Model Document Type Definition [calsdtd].

Attributes

Common attributes and common linking attributes.

colsep

Specifies the presence or absence of the column separator

Enumerated values:
“0”	No column separator rule.
“1”	Provide a column separator rule on the right

floatstyle

Specifies style information to be used when rendering the float

frame

Specifies how the table is to be framed. Note that there is no way to obtain a border on only the starting edge (left, in left-to-right writing systems) of the table.

Enumerated values:
“all”	Frame all four sides of the table. In some environments with limited control over table border formatting, such as HTML, this may imply additional borders.
“bottom”	Frame only the bottom of the table.
“none”	Place no border on the table. In some environments with limited control over table border formatting, such as HTML, this may disable other borders as well.
“sides”	Frame the left and right sides of the table.
“top”	Frame the top of the table.
“topbot”	Frame the top and bottom of the table.

label

Specifies an identifying string for presentation purposes

orient

Specifies the orientation of the table

Enumerated values:
“land”	90 degrees counter-clockwise from the rest of the text flow.
“port”	The same orientation as the rest of the text flow.

pgwide

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).
“1”	The element should be rendered across the full text page.

rowheader

Indicates whether or not the entries in the first column should be considered row headers

Enumerated values:
“firstcol”	Indicates that entries in the first column of the table are functionally row headers (analogous to the way that a thead provides column headers).
“norowheader”	Indicates that entries in the first column have no special significance with respect to column headers.

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”	No row separator rule.
“1”	Provide a row separator rule below

shortentry

Indicates if the short or long title should be used in a List of Tables

Enumerated values:
“0”	Indicates that the full title should be used.
“1”	Indicates that the short short title (titleabbrev) should be used.

tabstyle

Specifies the table style

tocentry

Indicates if the table should appear in a List of Tables

Enumerated values:
“0”	Indicates that the table should not occur in the List of Tables.
“1”	Indicates that the table should appear in the List of Tables.

Parents

This element occurs in 72 elements.

Children

This element contains 12 elements.

Examples

  1 <article xmlns='http://docbook.org/ns/docbook'>
  2 <title>Example table</title>
    
  4 <table xml:id="ex.calstable" frame='all'>
    <title>Sample CALS Table</title>
  6 <tgroup cols='5' align='left' colsep='1' rowsep='1'>
    <colspec colname='c1'/>
  8 <colspec colname='c2'/>
    <colspec colname='c3'/>
 10 <colspec colnum='5' colname='c5'/>
    <thead>
 12 <row>
      <entry namest="c1" nameend="c2" align="center">Horizontal Span</entry>
 14   <entry>a3</entry>
      <entry>a4</entry>
 16   <entry>a5</entry>
    </row>
 18 </thead>
    <tfoot>
 20 <row>
      <entry>f1</entry>
 22   <entry>f2</entry>
      <entry>f3</entry>
 24   <entry>f4</entry>
      <entry>f5</entry>
 26 </row>
    </tfoot>
 28 <tbody>
    <row>
 30   <entry>b1</entry>
      <entry>b2</entry>
 32   <entry>b3</entry>
      <entry>b4</entry>
 34   <entry morerows='1' valign='middle'><para>Vertical Span</para></entry>
    </row>
 36 <row>
      <entry>c1</entry>
 38   <entry namest="c2" nameend="c3" align='center' morerows='1' valign='bottom'>Span Both</entry>
      <entry>c4</entry>
 40 </row>
    <row>
 42   <entry>d1</entry>
      <entry>d4</entry>
 44   <entry>d5</entry>
    </row>
 46 </tbody>
    </tgroup>
 48 </table>
    
 50 </article>

Table 3. Sample CALS Table

Horizontal Span		a3	a4	a5
f1	f2	f3	f4	f5
b1	b2	b3	b4	Vertical Span
c1	Span Both		c4	Vertical Span
d1	Span Both		d4	d5


systemitem		table (db.html.table)