DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

tgroup

Name

tgroup -- A wrapper for the main content of a table, or part of a table

Synopsis

Content Model

tgroup ::=
(colspec*,spanspec*,thead?,tfoot?,tbody)

Attributes

Common attributes

Name	Type	Default
rowsep	NUMBER	None
colsep	NUMBER	None
align	Enumeration: center char justify left right	None
cols	NUMBER	Required
tgroupstyle	NMTOKEN	None
charoff	NUTOKEN	None
char	CDATA	None

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Parameter Entities

%tbl.table-main.mdl;

%tbl.table.mdl;

Description

A TGroup surrounds a logically complete portion of a table. Most tables consist of a single TGroup, but complex tables with widely varying column specifications may be easier to code using multiple TGroups.

The TGroup specifies the number of columns in the table, and contains all of the header, body, and footer rows, along with any additional column or span specifications necessary to express the geometry of the table.

Most of the properties of rows, columns, and cells inherit their default characteristics from the enclosing TGroup.

Processing expectations

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.

Parents

These elements contain tgroup: InformalTable, Table.

Children

The following elements occur in tgroup: colspec, spanspec, tbody, tfoot, thead.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

Attributes

align

Align specifies the horizontal alignment of Entrys (or EntryTbls) in cells of the TGroup. If Char is specified, see also Char and CharOff. Individual columns, spans, and cells can provide an alternate alignment.

char

Char specifies the alignment character when the Align attribute is set to Char.

charoff

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.

cols

Cols specifies the number of columns in the table.

colsep

If ColSep has the value 1 (true), then a rule will be drawn to the right of all columns in this TGroup. 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 not the ColSep.

rowsep

If RowSep has the value 1 (true), then a rule will be drawn below all the rows in this TGroup (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 of the enclosing Table or InformalTable and the RowSep of the last row is ignored. If unspecified, this attribute is inherited from enclosing elements.

tgroupstyle

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

See Also

colspec, entry, entrytbl, InformalTable, row, spanspec, Table, tbody, tfoot, thead

Examples

For examples, see entrytbl, FootnoteRef, InformalTable, RefEntry, Table.

---

Prev	Home	Next
tfoot	Up	thead

Back to: DocBook: The Definitive Guide