Whole document tree


www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage
 

Copyright (C) 2000-2012
Philippe Troin
<webmaster@fifi.org>.

Validate HTML
Validate CSS

    

Whole document tree

tgroup
Guide to the DocBook DTD
PrevNext

tgroup

Name

tgroup -- Wrapper for part of a Table that contains an array along with its formatting information

Content Model

  colspec*, spanspec*, thead?, tfoot?, tbody

Attributes

This element has common and Role attributes.

NameValue(s)TypeDefault Value
align(left|right|center|justify|char)#IMPLIED 
charCDATA#IMPLIED 
charoffNUTOKEN#IMPLIED 
colsNUMBER#REQUIRED 
colsepNUMBER#IMPLIED 
rowsepNUMBER#IMPLIED 
tgroupstyleNMTOKEN#IMPLIED 

Tag Minimization

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

Description

Wrapper for part of a Table that contains an array along with its formatting information. In order, a TGroup has any number of ColSpecs, any number of SpanSpecs, an optional THead, a required TBody, and an optional TFoot. TGroup has common, Align, Char, Charoff, Cols, Colsep, Rowsep, and TGroupStyle attributes.

Processing Expectations

Each TGroup effectively identifies a new portion of a Table. If a new ColSpec is provided, it replaces a previous one. If both ColSpec and SpanSpec are new, that SpanSpec should refer to columns in the most recent ColSpec. If only a new SpanSpec is provided, it should refer to columns defined by the most immediately prior ColSpecs in a TGroup of the Table. On the other hand, a new ColSpec to either a THead or TFoot replaces all prior column definitions.

Parents

These elements contain tgroup: InformalTable, Table.

Children

tgroup contains these elements: colspec, spanspec, tbody, tfoot, thead.

In some contexts, some of these elements may be invalid due to exclusions in parent elements.

Attributes

cols

Number of columns in the table.

tgroupstyle

TGroupstyle is a unique table group style defined in a FOSI.

colsep

For EntryTbl, if the value of Colsep is 1 (yes), display the internal column rulings to the right of the EntryTbl, except if the EntryTbl falls in the the last column, where the side rule setting applies; if 0 (no), do not display it. There is no default. The value is inherited from the enclosing TGroup.

rowsep

Rowsep controls the occurance of horizontal rules between table rows. A value of 1 (yes) specifies that a rule should occur. A value of 0 (no) specifies that it should not. Rowsep is inherited from enclosing table elements.

align

Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). There is no default except for SpanSpec, where the default is Center. For Entry and EntryTbl, the value may be inherited from ColSpec or SpanSpec.

char

Specifies the alignment character

charoff

Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char. For Entry, the default is inherited from ColSpec or SpanSpec. For ColSpec and EntryTbl, the default is inherited from the enclosing TGroup. For SpanSpec, the default is inherited from the ColSpec of the column named by Namest.

Examples

<TABLE COLSEP="1" FRAME="all" ROWSEP="0"
SHORTENTRY="0" TOCENTRY="1" TABSTYLE="decimalstyle"
ORIENT="land" PGWIDE="0">
<TITLE>Sample Decimal-Aligned Table</TITLE>
<TITLEABBREV>Decimal-Aligned Table</TITLEABBREV>
<TGROUP ALIGN="char" CHAROFF="50" CHAR="." COLS="4">
<COLSPEC ALIGN="left" COLNUM="1" COLSEP="0" COLWIDTH="7pc">
<THEAD>
<ROW>
<ENTRY>Gas Ball</ENTRY>
<ENTRY>1940</ENTRY>
<ENTRY>1960</ENTRY>
<ENTRY>1980</ENTRY>
</ROW>
</THEAD>
<TFOOT>
<ROW>
<ENTRY>Rating</ENTRY>
<ENTRY>3</ENTRY>
<ENTRY>1</ENTRY>
<ENTRY>2</ENTRY>
</ROW>
</TFOOT>
<TBODY>
<ROW>
<ENTRY>Diameter</ENTRY>
<ENTRY>345.021</ENTRY>
<ENTRY>211.02</ENTRY>
<ENTRY>221.3</ENTRY>
</ROW>
<ROW>
<ENTRY>Color</ENTRY>
<ENTRY>blue</ENTRY>
<ENTRY>red</ENTRY>
<ENTRY>yellow</ENTRY>
</ROW>
</TBODY>
</TGROUP>
</TABLE>
<TABLE FRAME="all">
<TITLE>Table With SpanSpec</TITLE>
<TGROUP COLS="5" COLSEP="1" ROWSEP="1">
<COLSPEC COLWIDTH="91*">
<COLSPEC COLNAME="col2" COLWIDTH="91*">
<COLSPEC COLNAME="col3" COLWIDTH="91*">
<COLSPEC COLNAME="col4" COLWIDTH="91*">
<COLSPEC COLNAME="col5" COLWIDTH="92*">
<SPANSPEC NAMEEND="col5" NAMEST="col4" SPANNAME="4to5">
<TBODY>
<ROW>
<ENTRY ALIGN="center" COLNAME="col2" VALIGN="middle">Software 1</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 2</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 3</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 4</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 1</ENTRY>
<ENTRY ALIGN="center" MOREROWS="1" VALIGN="middle">25 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">10 MB</ENTRY>
<ENTRY ALIGN="center" SPANNAME="4to5" VALIGN="middle">34 MB</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 2</ENTRY>
<ENTRY ALIGN="center" COLNAME="col3" VALIGN="middle">12 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">30 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">35 MB</ENTRY></ROW></TBODY></TGROUP>
</TABLE>
PrevHomeNext
tfootUpthead