table

$Revision: 1.5 $

$Date: 2002/06/12 11:18:40 $

table — A formal table in a document

Synopsis

Content Model

table ::=
(((blockinfo?,
   (title,titleabbrev?),
   (indexterm)*,
   textobject*,
   (graphic+|mediaobject+|tgroup+))|
  (caption,
   (col*|colgroup*),
   thead?,tfoot?,
   (tbody+|tr+))))

Attributes

Common attributes

Name

Type

Default

rowsep

CDATA

None

ondblclick

CDATA

None

onkeydown

CDATA

None

onkeyup

CDATA

None

onmouseup

CDATA

None

onmouseover

CDATA

None

align

Enumeration:

center

left

right

None

pgwide

CDATA

None

orient

Enumeration:

land

port

None

onkeypress

CDATA

None

onmousedown

CDATA

None

onclick

CDATA

None

title

CDATA

None

class

CDATA

None

label

CDATA

None

width

CDATA

None

frame

Enumeration:

above

all

below

border

bottom

box

hsides

lhs

none

rhs

sides

top

topbot

void

vsides

None

rules

Enumeration:

all

cols

groups

none

rows

None

summary

CDATA

None

bgcolor

CDATA

None

tabstyle

CDATA

None

cellspacing

CDATA

None

colsep

CDATA

None

shortentry

CDATA

None

onmouseout

CDATA

None

onmousemove

CDATA

None

style

CDATA

None

xml:lang

NMTOKEN

None

border

CDATA

None

cellpadding

CDATA

None

tocentry

CDATA

None

DocBook NG “Bourbon” Content Model

table (cals.table) ::=

Sequence of:

One of:

Sequence of:

Interleave of:

title
titleabbrev?

info? (db.info.titleforbidden)

info (db.info.titleonlyreq)

Zero or more of:

indexterm (indexterm.endofrange)
indexterm (indexterm.singular)
indexterm (indexterm.startofrange)

Zero or more of:

textobject

One of:

One or more of:

mediaobject

One or more of:

tgroup

DocBook NG “Bourbon” Attributes

Common attributes and common linking attributes.

Additional attributes: (Required attributes, if any, are bold)

colsep
frame (enumeration)
- “all”
- “bottom”
- “none”
- “sides”
- “top”
- “topbot”
orient (enumeration)
- “land”
- “port”
pgwide (enumeration)
- “0”
- “1”
rowsep
tabstyle

table (html.table) ::=

Sequence of:

caption
One of:

Zero or more of:

col

Zero or more of:

colgroup

thead? (html.thead)
tfoot? (html.tfoot)
One of:

One or more of:

tbody (html.tbody)

One or more of:

tr

DocBook NG “Bourbon” Attributes

Attributes: (Required attributes, if any, are bold)

border
cellpadding
cellspacing
class
dir (enumeration)
- “ltr”
- “rtl”
frame (enumeration)
- “void”
- “above”
- “below”
- “hsides”
- “lhs”
- “rhs”
- “vsides”
- “box”
- “border”
lang
onclick
ondblclick
onkeydown
onkeypress
onkeyup
onmousedown
onmousemove
onmouseout
onmouseover
onmouseup
rules (enumeration)
- “none”
- “groups”
- “rows”
- “cols”
- “all”
style
summary
title
width

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 .

Future Changes

The OASIS Exchange Table Model will replace the full OASIS Table Model.

Parents

These elements contain table: answer, appendix, article, bibliodiv, bibliography, blockquote, callout, caution, chapter, constraintdef, glossary, glossdef, glossdiv, important, index, listitem, msgexplan, msgtext, note, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, tip, warning.

Children

The following elements occur in table: blockinfo, caption, col, colgroup, graphic, indexterm, mediaobject, tbody, textobject, tfoot, tgroup, thead, title, titleabbrev, tr.

Attributes

colsep

If ColSep has the value 1 (true), then a rule will be drawn to the right of all columns in this table. A value of 0 (false) suppresses the rule. The rule to the right of the last column in the table is controlled by the Frame attribute, not the ColSep.

frame

Frame specifies how the table is to be framed:

Value	Meaning
`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.

There is no way to obtain a border on only the starting edge (left, in left-to-right writing systems) of the table.

label

Label specifies an identifying string for presentation purposes.

Generally, an explicit Label attribute is used only if the processing system is incapable of generating the label automatically. If present, the Label is normative; it will used even if the processing system is capable of automatic labelling.

orient

Orient specifies the orientation of the Table. An orientation of Port is the “upright”, the same orientation as the rest of the text flow. An orientation of Land is 90 degrees counterclockwise from the upright orientation.

pgwide

If Pgwide has the value 0 (false), then the Table is rendered in the current text flow (with flow column width). A value of 1 (true) specifies that the table should be rendered across the full text page.

rowsep

If RowSep has the value 1 (true), then a rule will be drawn below all the rows in the Table (unless other, interior elements, suppress some or all of the rules). A value of 0 (false) suppresses the rule. The rule below the last row in the table is controlled by the Frame attribute and the RowSep of the last row is ignored.

shortentry

If ShortEntry has the value 1 (true), then the Table's TitleAbbrev will be used in the LoT, Index, etc. A value of 0 (false) indicates that the full Title should be used in those places.

tabstyle

TabStyle holds the name of a table style defined in a stylesheet (e.g., a FOSI) that will be used to process this document.

tocentry

If ToCEntry has the value 1 (true), then the Table will appear in a generated List of Tables. The default value of 0 (false) indicates that it will not.

Examples

<!DOCTYPE table PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<table frame='all'><title>Sample 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>  <!-- Pernicous Mixed Content -->
  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>

Table 2. Sample 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		task

table

Synopsis

Content Model

Attributes

DocBook NG “Bourbon” Content Model

DocBook NG “Bourbon” Attributes

DocBook NG “Bourbon” Attributes

Description

Processing expectations

Future Changes

Parents

Children

Attributes

See Also

Examples