table — A formal table in a document
table (db.cals.table) ::= ((((title
&
titleabbrev
?),
info
? db.titleforbidden.info) |
info
db.titleonlyreq.info),
(alt
? & Indexing inlines* &
textobject
*), (mediaobject
+ |
tgroup
+),
caption
? db.caption)
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”
example
must not occur among the children
or descendants of table
.
figure
must not occur among the children
or descendants of table
.
equation
must not occur among the
children or descendants of table
.
informaltable
must not occur among the
children or descendants of table
.
caution
must not occur among the children
or descendants of table
.
important
must not occur among the
children or descendants of table
.
note
must not occur among the children or
descendants of table
.
tip
must not occur among the children or
descendants of table
.
warning
must not occur among the children
or descendants of table
.
This table
element identifies a formal table
(one without 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.
Formatted as a displayed block. This element is expected to obey the semantics of the CALS Table Model Document Type Definition [calsdtd].
Common attributes and common linking attributes.
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. |
Specifies style information to be used when rendering the float.
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. |
Specifies an identifying string for presentation purposes.
Specifies the orientation of the table.
Enumerated values: | |
---|---|
“land” | 90 degrees counterclockwise from the rest of the text flow. |
“port” | 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). |
“1” | The element should be rendered across the full text page. |
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 |
“norowheader” | Indicates that entries in the first column have no special significance with respect to column headers. |
Specifies the presence or absence of the row separator.
Enumerated values: | |
---|---|
“0” | No row separator rule. |
“1” | Provide a row separator rule below. |
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 title
( |
Specifies the table style.
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. |
colspec
, entry
, entrytbl
, equation
, example
, figure
, informalequation
, informalexample
, informalfigure
, informaltable
, row
, spanspec
, table
(db.html.table), tbody
, tfoot
, tgroup
, thead
<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>