table (db.cals.table)

table — A formal table in a document

Synopsis

Content Model

table (db.cals.table) ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • colsep
  • floatstyle
  • frame (enumeration)
    • “all”
    • “bottom”
    • “none”
    • “sides”
    • “top”
    • “topbot”
  • orient (enumeration)
    • “land”
    • “port”
  • pgwide (enumeration)
    • “0”
    • “1”
  • rowheader (enumeration)
    • “firstcol”
    • “norowheader”
  • rowsep
  • 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
  • table must not occur in the descendants of table
  • table 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 must not occur in the descendants of table
  • informaltable must not occur in the descendants of table

Description

The Table element identifies a formal table. DocBook uses the CALS table model, which describes tables geometrically using rows, columns, and cells.

Tables may include column headers and footers, but there is no provision for 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, as specified by OASIS Technical Memorandum TM 9502:1995.

Attributes

Common attributes and common linking attributes.

colsep

Specifies the presence or absence of the column separator

floatstyle

Specifies style information to be used when rendering the float

frame

Specifies how the table is to be framed

Enumerated values:

all

FIXME:

bottom

FIXME:

none

FIXME:

sides

FIXME:

top

FIXME:

topbot

FIXME:

orient

Specifies the orientation of the table

Enumerated values:

land

FIXME:

port

FIXME:

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

FIXME:

norowheader

FIXME:

rowsep

Specifies the presence or absence of the row separator

shortentry

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

Enumerated values:

0

FIXME:

1

FIXME:

tabstyle

Specifies the table style

tocentry

Indicates if the table should appear in a List of Tables

Enumerated values:

0

FIXME:

1

FIXME:

Children

The following elements occur in table: alt, caption (db.caption), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonlyreq.info), mediaobject, textobject, tgroup, title, titleabbrev.

See Also

colspec, entry, entrytbl, equation, example, figure, informalequation, informalexample, informalfigure, informaltable, row, spanspec, table (db.html.table), tbody, tfoot, tgroup, thead

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example table</title>

<table xml:id="ex.calstable" frame='all'>
<title>Sample CALS Table</title>
<tgroup cols='5' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<colspec colnum='5' colname='c5'/>
<thead>
<row>
  <entry namest="c1" nameend="c2" align="center">Horizontal Span</entry>
  <entry>a3</entry>
  <entry>a4</entry>
  <entry>a5</entry>
</row>
</thead>
<tfoot>
<row>
  <entry>f1</entry>
  <entry>f2</entry>
  <entry>f3</entry>
  <entry>f4</entry>
  <entry>f5</entry>
</row>
</tfoot>
<tbody>
<row>
  <entry>b1</entry>
  <entry>b2</entry>
  <entry>b3</entry>
  <entry>b4</entry>
  <entry morerows='1' valign='middle'><para>Vertical Span</para></entry>
</row>
<row>
  <entry>c1</entry>
  <entry namest="c2" nameend="c3" align='center' morerows='1' valign='bottom'>Span Both</entry>
  <entry>c4</entry>
</row>
<row>
  <entry>d1</entry>
  <entry>d4</entry>
  <entry>d5</entry>
</row>
</tbody>
</tgroup>
</table>

</article>

Table 1. Sample CALS Table

Horizontal Spana3a4a5
f1f2f3f4f5
b1b2b3b4

Vertical Span

c1Span Bothc4
d1d4d5

ChangeLog

This alpha reference page is $Revision: 1.5 $ published $Date: 2005/07/07 16:41:41 $.