<colspec> Table Column Specification

<colspec> is an empty formatting element used to designate the position and size of each column in a <table>, used within the <tgroup> wrapper. It may designate specify a unique name for the column, its unique number within the table, its width, rules, and the horizontal alignment of its text.

Attributes

  • @align – not required. Designates the horizontal position of text within a column. Values may be: left, right, center, char, justify (flush left and right).
  • @char – not required. Used for horizontal alignment of a single character, such as decimal alignment. This attribute names the character on which the text will be aligned, for example a decimal point, an asterisk, or an em-dash.
  • @charoff – not required. Used with horizontal character alignment, such as decimal alignment. When the @align attribute value is “char,” this is the percentage of the current column width to the left edge of the alignment character. Value is a number or starts with a number.
  • @colname – not required. Letters and/or numbers (no spaces) used to give the column a unique name.
  • @colnum – not required. The number of the column, as counting from the left.
  • @colsep – not required. Use “true” to display a vertical rule to the right of the column, “false” for no vertical rule.
  • @colwidth – not required. A fixed width for the column. Units may be “pt,” “cm,” “in,” and an * for proportional measures, such as “5*”.
  • @rowsep – not required. Use “true” to display a horizontal rule below the row and “false” for no horizontal rule.

Child Elements

<colspec> is an empty element and only contains data through its attributes.

Examples

This example is modified from the original example file:

<table frame="all" colsep="true" rowsep="true">
	<head>Categorized Restrictions on Access</head>
	<tgroup align="center" cols="3">
		<colspec colname="materialtype" colnum="1"/>
		<colspec colname="usepermitted" colnum="2"/>
		<colspec colname="permissionrequired" colnum="3"/>
		<thead valign="middle">
			<row>
				<entry colname="materialtype">Material Type</entry>
				<entry colname="usepermitted">Use Type</entry>
				<entry colname="permissionrequired">Permission Required</entry>
			</row>
		</thead>
		<tbody valign="middle">
			<row>
				<entry colname="materialtype">Journals</entry>
				<entry colname="usepermitted">Personal notes</entry>
				<entry colname="permissionrequired">none required</entry>
			</row>
			<row>
				<entry colname="materialtype">Journals</entry>
				<entry colname="usepermitted">Publication</entry>
				<entry colname="permissionrequired">Archivist</entry>
			</row>
			<row>
				<entry colname="materialtype">Letters</entry>
				<entry colname="usepermitted">Personal notes</entry>
				<entry colname="permissionrequired">none required</entry>
			</row>
			<row>
				<entry colname="materialtype">Letters</entry>
				<entry colname="usepermitted">Publication</entry>
				<entry colname="permissionrequired">Archivist</entry>
			</row>
			<row>
				<entry colname="materialtype">Class notes</entry>
				<entry colname="usepermitted">Personal notes</entry>
				<entry colname="permissionrequired">Archivist</entry>
			</row>
			<row>
				<entry colname="materialtype">Class notes</entry>
				<entry colname="usepermitted">Publication</entry>
				<entry colname="permissionrequired">Archivist and Headmaster</entry>
			</row>
			<row>
				<entry colname="materialtype">Spell books</entry>
				<entry colname="usepermitted">Personal notes</entry>
				<entry colname="permissionrequired">Archivist and Headmaster</entry>
			</row>
			<row>
				<entry colname="materialtype">Spell books</entry>
				<entry colname="usepermitted">Publication</entry>
				<entry colname="permissionrequired">Not permitted</entry>
			</row>
		</tbody>
	</tgroup>
</table>

Changes from EAD 2002

No changes from EAD 2002.

EAD3 Tag Library Entry

View the official tag library entry for <colspec>