PSML

A complete reference of PageSeeder's markup language PSML

<col>

Summary

The <col> element defines a column in a table.

It is an optional element akin to the HTML's <col> or docbook <colspec> elements.

It can be used to specify some properties such as width, horizontal alignment or role to a column or a range of columns so that all cells belonging to that column inherit these properties.

A column can also be defined being a header column meaning that all the cells in the column are considered to be header cells.

Usage context

Element categorytable
PSML levelportable
Permitted contentnone
Permitted parent<table>
HTML equivalent<col> or <colspan>
OpenXML equivalent<w:gridCol> in <w:tblGrid>
PSStandard equivalent<colspec>

Attributes

This element includes the following attributes:

NameTypeRequiredDescription
alignalignmentnoHorizontal alignment of cell within that column
parttable-partnoThe part of the table the column belongs to.
rolerolenoCustom value that can be used for formatting.
spanxs:positiveIntegernoThe  number of columns this definition extends to
widthwidthnoWidth of column in pixels or percent.

@align

The horizontal alignment of text within cells belonging to that column.

@part

The part of the table the column belongs to.

For example, if a <col> element includes a @part attribute set to"header", all cells in that column will be considered to be header cells.

@role

A role for the table which can be used for formatting.

@span

The number of columns this definition extends to.

@width

The width of column in pixels or percent (pixels if no px or % suffix).

Examples

Schema

XML Schema

<xs:element name="col">
   <xs:complexType>
     <xs:attribute name="width">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value="[0-9\.]+(px|%)?"/>
          </xs:restriction>
        </xs:simpleType>
      </xs:attribute>
      <xs:attribute name="span"  type="xs:positiveInteger"/>
      <xs:attribute name="align">
         <xs:simpleType>
            <xs:restriction base="xs:string">
               <xs:enumeration value="left" />
               <xs:enumeration value="center" />
               <xs:enumeration value="right" />
               <xs:enumeration value="justify" />
            </xs:restriction>
         </xs:simpleType>
      </xs:attribute>
      <xs:attribute name="role" type="role"/>
   </xs:complexType>
</xs:element>

Relax Schema

element col {
   attribute width { text { pattern: "[0-9\.]+(px|%)?" } }?,
   attribute span { xs:positiveInteger }?,
   attribute align { "center" | "justify" | "left" | "right" }?,
   attribute role { role }?,
   empty
}

Compatibility

This element was introduced in PSML Beta 7 and is only supported from PageSeeder 5.6.

See also

Created on , last edited on