colspec

The <colspec> element contains a column specification for a table, including assigning a column name and number, cell content alignment, and column width.

Example

See table.

Contains

Doctype Content model
ditabase, topic, task, reference, concept, glossary, map, bookmap no content

Contained by

Doctype Parents
bookmap, map, ditabase, topic, task, concept, reference, glossary tgroup

Inheritance:

- topic/colspec

Attributes

Name Description Data Type Default Value Required?
colnum Indicates the number of a column in the table, counting from the first logical column to the last column. NMTOKEN #IMPLIED No
colname Specifies the table column name in which an entry is found. NMTOKEN #IMPLIED No
colwidth Describes the column width. CDATA #IMPLIED No
colsep Column separator. A value of 0 indicates no separators; 1 indicates separators. NMTOKEN #IMPLIED No
rowsep Row separator. A value of 0 indicates no separators; 1 indicates separators. NMTOKEN #IMPLIED No
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.
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.
(left | right | center | justify | char | -dita-use-conref-target) #IMPLIED No
char alignment character

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.

CDATA #IMPLIED No
charoff 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.

NMTOKEN #IMPLIED No
base A generic attribute that has no specific purpose, but is intended to act as a base for specialized attributes that have a simple value syntax like the conditional processing attributes (one or more alphanumeric values separated by whitespace). The attribute takes a space delimited set of values. However, when acting as a container for generalized attributes, the content model will be more complex; that model is documented in the "attribute generalization" section of the DITA architectural specification. CDATA #IMPLIED No
%id-atts; (id, conref) A set of related attributes, described at %id-atts; parameter entity PE not applicable Not applicable
%localization-atts; (translate, xml:lang, dir) A set of related attributes, described at %localization-atts;. parameter entity PE not applicable Not applicable
%global-atts; (xtrf, xtrc) A set of related attributes, described at %global-atts; parameter entity PE not applicable Not applicable
class Common attribute described in Other common DITA attributes.      

Return to main page.

OASIS DITA Language Specification v1.1 -- Committee Draft 02, 8 May 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.