Language reference : Base architecture : Topic elements : Table elements : colspec
   
colspec
The <colspec> element contains a column specification for a table, including assigning a column name and number, cell content alignment, and column width.
Contains
Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
Doctype
Content model
topic, map, concept, ditabase, glossary, glossentry, glossgroup, reference, task, bookmap, classifyMap, subjectScheme, machineryTask, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary
no content
Contained by
Doctype
Content model
topic (base), map (base), topic (technical content), map (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task (strict), task (general), bookmap, classifyMap, subjectScheme, machineryTask, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary
Inheritance
- topic/colspec
Example 74. Example
See table.
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.
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.
 
(left | right | center | justify | char | -dita-use-​conref-​target)
#IMPLIED
No
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", then text in the entry should align with the first occurrence of the letter "r" within the entry.
 
CDATA
#IMPLIED
No
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", 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.
 
NMTOKEN
#IMPLIED
No
base
A generic attribute that has no specific purpose. It 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), but is not itself a filtering or flagging attribute. 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; see Attribute generalization for more details.
CDATA
#IMPLIED
No
id-atts attribute group (id, conref, conrefend, conaction, conkeyref)
A set of related attributes, described in id-atts attribute group
localization-atts attribute group (translate, xml:lang, dir)
A set of related attributes, described in localization-atts attribute group.
global-atts attribute group (xtrf, xtrc)
A set of related attributes, described in global-atts attribute group
class
A common attribute described in Other common DITA attributes