Complex-table attribute group

Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition

version
1.3
author
OASIS DITA Technical Committee

The Complex-table attribute group includes several attributes that are defined on complex table elements. Most of these attributes are part of the OASIS Exchange model; table elements generally use only a subset of the attributes defined in this group. These attributes are not available for the simpletable elements.

align
Describes the alignment of text in a table column. Allowable values are:
left
Indicates left alignment of the text.
right
Indicates right alignment of the text.
center
Indicates center alignment of the text.
justify
Justifies the contents to both the left and the right.
char
Use the character specified on the char attribute for alignment.
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.

The align attribute is available on the following table elements: tgroup, colspec, and entry.

char
Specifies the character for aligning the table entry data.

Default source for entry elements starting in this column. If character alignment is specified, the value is the single alignment character source for any implied char values for entry immediately in this column. A value of "" (the null string) means there is no aligning character.

For example, if align="char" and char="r" are specified, then text in the entry should align with the first occurrence of the letter "r" within the entry.

The char attribute is available on the following table elements: colspec and entry.

charoff
Specifies the horizontal offset of alignment character when align="char".

Default source for entry elements starting in this column. For character alignment on an entry in the column, horizontal character offset is the percent of the current column width to the left of the (left edge of the) alignment character.

This value should be number, greater than 0 and less than or equal to 100.

For example, if align="char", char="r", and charoff="50" are all specified, then text in the entry should align 50% of the distance to the left of the first occurrence of the character "r" within the entry.

The charoff attribute is available on the following table elements: colspec and entry.

colsep
Column separator. A value of 0 indicates no separators; 1 indicates separators.

The colsep attribute is available on the following table elements: table, tgroup, colspec, and entry.

rowsep
Row separator. A value of 0 indicates no separators; 1 indicates separators.

The rowsep attribute is available on the following table elements: table, tgroup, row, colspec, and entry.

rowheader
Indicates whether the entries in the respective column SHOULD be considered row headers. Allowable values are:
firstcol
Indicates that entries in the first column of the table are functionally row headers (analogous to the way that a thead element provides column headers). Applies when rowheader is used on the table element.
headers
Indicates that entries of a column described using the colspec element are functionally row headers (for cases with more than one column of row headers). Applies when rowheader is used on the colspec element.
norowheader
Indicates that entries in the first column have no special significance with respect to column headers. Applies when rowheader is used on the table element.
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.
Note: This attribute is not part of the OASIS Exchange Table model upon which DITA tables are based. Some DITA processors or output formats might not support all values.

The rowheader attribute is available on the following table elements: table and colspec.

valign
Indicates the vertical alignment of text in a table entry (cell). Allowable values are:
top
Align the text to the top of the table entry (cell).
bottom
Align the text to the bottom of the table entry (cell).
middle
Align the text to the middle of the table entry (cell).
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.

The valign attribute is available on the following table elements: thead, tbody, row, and entry.