tgroup

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

Synopsis

tgroup ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • align (enumeration)
    • “center”
    • “char”
    • “justify”
    • “left”
    • “right”
  • char
  • charoff (decimal)
  • cols (positiveInteger)
  • colsep (enumeration)
    • “0”
    • “1”
  • rowsep (enumeration)
    • “0”
    • “1”
  • tgroupstyle

Required attributes are shown in bold.

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 [calsdtd].

Attributes

Common attributes and common linking attributes.

align

Specifies the horizontal alignment of text in an entry.

Enumerated values:
“center”

Centered.

“char”

Aligned on a particular character.

“justify”

Left and right justified.

“left”

Left justified.

“right”

Right justified.

char

Specifies the alignment character when align 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 align is set to “char” .

cols

The number of columns in the table. Must be an integer greater than zero.

colsep

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

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”

No row separator rule.

“1”

Provide a row separator rule below

tgroupstyle

Additional style information for downstream processing; typically the name of a style.

Parents

These elements contain tgroup: informaltable, table.

Children

The following elements occur in tgroup: colspec, spanspec, tbody (db.cals.tbody), tfoot, thead (db.cals.thead).

Last revised by Norman Walsh on (git hash: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)