View Source

h2. Overview
_Since 3.0_


The _ace:columnGroup_ renders a header of footer segment of an HTML table element. Rows are created from [_ace:row_|Row] components with [_ace:column_|Column] children. The most notable feature of using ColumnGroup to define a header or footer over Column facets, is Column rowSpan and colSpan capability.

{tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=aceMenu&exp=columnGroupBean] of this component, complete with source code.{tip}

h2. Getting Started
{code}
<ace:columnGroup type="header">
<ace:row>
<ace:column colSpan="2">
Track
</ace:column>
<ace:column rowSpan="2">
Download
</ace:column>
</ace:row>
<ace:row>
<ace:column>
Artist
</ace:column>
<ace:column>
Album
</ace:column>
</ace:row>
</ace:columnGroup>
{code}

h2. Attributes

{tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://res.icesoft.org/docs/v4_latest/ace/tld/ace/columnGroup.html].{tip}

{panel}
The *type* attribute defines the segment of the table to render using this ColumnGroup, either 'header' or 'footer'.
{panel}
h2. Known Issues

h2. Other Resources

{anchor:related}

h3. Related Components

* _[DataTable|DataTable]_
* _[Column|Column]_
* _[Row|Row]_