<tgroup> Table Group

<tgroup> is a formatting element that bundles <colspec>, <thead>, and <tbody> elements that all use the same column specifications within a <table>. Tables may have multiple <tgroup> elements if the column specifications change.

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).
  • @altrender – not required. Use if the content of the element should be displayed or printed differently than the rendering established in a style sheet for other occurrences of the element.
  • @audience – not required. Use to set whether the element’s contents will be visible to external users or to internal ones. Possible values are: “internal” and “external.”
  • @colsrequired. Specifies the number of columns in the table.
  • @colsep – not required. Use “true” to display a vertical rule to the right of the entry’s column and “false” for no vertical rule.
  • @id – not required. Creates an ID for element. Can be used for linking.
  • @lang – not required. Three-letter code that indicates the language in which the element’s contents were written. It should come from ISO 639-2b.
  • @rowsep – not required. Use “true” to display a horizontal rule below the row and “false” for no horizontal rule.
  • @script – not required. Four-letter code that indicates the script in which the element’s contents were written. It should come from ISO 15924.

Child Elements

<tgroup> may (and by best practices should) contain:

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

<tgroup> gained attributes @lang and @script.

EAD3 Tag Library Entry

View the official tag library entry for <tgroup>