    | DocBook: The Definitive Guide 2.0.17 (Alpha) |
| | DocBook: The Definitive Guide 2.0.17 (Alpha) |
$Revision: 1666 $
$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $
spanspec — Formatting information for a spanned column in a table
spanspec ::= EMPTY
Name | Type | Default | ||||||
| rowsep | CDATA | None | ||||||
| align |
| None | ||||||
| spanname | CDATA | Required | ||||||
| namest | CDATA | Required | ||||||
| char | CDATA | None | ||||||
| nameend | CDATA | Required | ||||||
| colsep | CDATA | None | ||||||
| charoff | CDATA | None |
The following parameter entities contain spanspec:
| Parameter Entities | ||
%tbl.entrytbl.mdl; | %tbl.tgroup.mdl; | |
A SpanSpec associates a name with a span between two columns
in a table. In the body of the table, cells can refer to the span by name.
Cells that refer to a span will span horizontally from the first column
to the last column, inclusive.
Cells can also form spans directly, by naming the start and end
columns themselves. The added benefit of a SpanSpec
is that it can associate formatting information (such as
alignment and table rule specifications) with the span. This information
does not need to be repeated then, on each spanning cell.
Suppressed. 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 .
The NameSt and NameEnd attributes of a SpanSpec must
refer to named ColSpecs in the same table. In other
words, if the SpanSpec
<spanspec spanname="fullyear" namest="jan" nameend="dec"/>exists in a table,
ColSpecs named “jan”
and “dec” must also exist in the same table.
Align specifies the horizontal alignment
of Entrys (or EntryTbls) in the span. The
default alignment is inherited from the enclosing TGroup.
If Char is specified, see also
Char and
CharOff.
Individual Entrys and
EntryTbls can specify an alternate alignment.
Char specifies the alignment character when
the Align attribute is set to Char.
CharOff specifies the percentage of the
column's total width that should appear to the left of the first
occurance of the character identified in Char when the Align
attribute is set to Char. This attribute is inherited from
the ColSpec of the column specified in
Namest or from the enclosing TGroup.
If ColSep has the value 1 (true), then
a rule will be drawn to the right of the spanning column described by this
SpanSpec. 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 of the enclosing
Table or InformalTable and the
ColSep of the last column in the table
is ignored. If unspecified, this attribute is inherited from
enclosing elements.
NameEnd is the name (defined in a
ColSpec) of the rightmost column of the span.
NameSt is the name (defined in a
ColSpec) of the leftmost column of the span.
If RowSep has the value 1 (true), then a
rule will be drawn below all the cells in this Span.
A value of 0 (false) suppresses the rule. The rule below the last row
in the table is controlled by the Frame
attribute of the enclosing Table or
InformalTable and the RowSep
of the last row is ignored. If unspecified, this attribute is
inherited from enclosing elements.
SpanName specifies a name by which
subsequent Entry and EntryTbls can refer to the
span defined in this SpanSpec.
| | | |
| simplesect | | state |