3.1.1.3.3 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

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

tgroup

Inheritance

- topic/colspec

Example

See 3.1.1.3.1 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 3.4.2.4.1 Using the -dita-use-conref-target value for more information. In DITA 1.0 and 1.1, char was defined as a legal value, but was not described. The 1.2 spec added a description for the "char" value (the value itself is not new).

(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.

CDATA

#IMPLIED

No

id-atts attribute group (id, conref, conrefend, conaction, conkeyref)

A set of related attributes, described in 3.4.1.4 id-atts attribute group

     

localization-atts attribute group (translate, xml:lang, dir)

A set of related attributes, described in 3.4.1.6 localization-atts attribute group.

     

global-atts attribute group (xtrf, xtrc)

A set of related attributes, described in 3.4.1.2 global-atts attribute group

     

class

A common attribute described in 3.4.1.9 Other common DITA attributes

     

Previous Topic:  3.1.1.3.2 tgroup

Next Topic:  3.1.1.3.4 thead

Parent Topic:  3.1.1.3 Table elements

Sibling Topics:

3.1.1.3.1 table

3.1.1.3.2 tgroup

3.1.1.3.4 thead

3.1.1.3.5 tbody

3.1.1.3.6 row

3.1.1.3.7 entry

3.1.1.3.8 simpletable

3.1.1.3.9 sthead

3.1.1.3.10 strow

3.1.1.3.11 stentry