colspec
Specifies a column, a vertical portion of a table. The default values come from the tgroup or thead starting the current (enclosing) group. Each
colspec
is for a single column in left-to-right order, so it properly has a column number, colnum, implicitly in order starting from 1, and an optional column name (colname) by which it is known when referenced by any entry . Any references from entrys within the thead to colname, namest, or nameend refer to values defined by the set ofcolspec
s in the containing tgroup.colspec
s from the containing tgroup apply to thead and tbody.The number of columns should be determined by the cols attribute on the tgroup element, not by the number of
colspec
s actually defined. If the number in cols is larger than the number ofcolspec
s, then additionalcolspec
s of colwidth "1*" should be inferred.colspec
s can be numbered or unnumbered, and if numbered should be increasing in sequential order starting with 1 at the left. Unnumberedcolspec
s are interpreted as being numbered incrementally (one more than the previous column number), with the firstcolspec
starting at 1. It is left up to the implementation how to handle any mismatch incolspec
numbering, or a number ofcolspec
s greater than cols. It is recommended that an authoring or editing implementation or any implementation that verifies the compliance of the table markup to this Memorandum offer the option of producing a warning message when it encounters such markup. It is an error for an authoring or editing implementation to produce a table with such conflicting markup.The char and charoff attributes are allowed on colspec as well as on entry. While an implementation should accept these attributes on either of these elements upon input, it may produce logically equivalent output that nevertheless differs with respect to these attributes and still be considered in compliance with the semantics of this Memorandum. If a table contains one or more entrys with values of either char or charoff that differ from the value for the same attribute on a
colspec
that logically contains the entry(s), it is left up to the implementation how this should be handled (i.e., the interpretation of such markup is beyond the scope of this model). It is recommended that an authoring or editing implementation or any implementation that verifies the compliance of the table markup to this Memorandum offer the option of producing a warning message when it encounters such markup. It is an error for an authoring or editing implementation to produce a table with such conflicting markup.
Element information
Namespace: None
Schema document: soextblx.xsd
Type: Anonymous
Properties: Global, Qualified
Content
- Empty content
Attributes
Name | Occ | Type | Description | Notes |
---|---|---|---|---|
colnum | [0..1] | xsd:NMTOKEN | column number. Number of column, counting from 1 at left of the table. The value of colnum is not useful to identify a column in an entry, so serves no functional purpose other than a consistency check on the order of the colspecs. | |
colname | [0..1] | xsd:NMTOKEN | column name. Name of column, used to specify the position or horizontal span of columns in a row by reference in entry using colname, namest, and/or nameend. | |
colwidth | [0..1] | xsd:anySimpleType | column width specification. Either proportional measure of the form number*, e.g., "5*" for 5 times the proportion, or "*" (which is equivalent to "1*"); fixed measure, e.g., 2pt for 2 point, 3pi for 3 pica. (Mixed measure, e.g., 2*+3pt, while allowed in the full CALS table model, is not supported in this Exchange model.) Coefficients are positive integers or fixed point numbers; for fixed point numbers, a leading (possibly 0) integer part is required, and implementations should support at least 2 decimal places. A value of "" [the null string] is treated as a proportional measure of "1*". | |
colsep | [0..1] | yesorno | column separators (vertical ruling). Specifies the presence or absence of column separator rules. Provides the default value for all descendant elements. | |
rowsep | [0..1] | yesorno | row separators (horizontal ruling). Specifies the presence or absence of row separator rules. Provides the default value for all descendant elements. | |
align | [0..1] | Anonymous | horizontal alignment of table entry content. Text horizontal position within the column. Applies to text that is #PCDATA or other in-line elements, not further contained in another element with its own formatting style, such as paragraph, list, or annotation. Default source for colspec align. Possible default source for entry. | |
char | [0..1] | xsd:string | alignment character. Default source for entrys 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. | |
charoff | [0..1] | xsd:integer | horizontal offset of alignment character when align=char. Default source for entrys 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. |
Used in
- Anonymous type of element tgroup
Sample instance
<colspec colname="c1"/>