# ListGroup

Represents a group break level within a list.

### Description

A list is most often divided into a number of groups. Groups provide a way of showing common headings for a group of related rows. Groups often have subtotals. For example, a sales report may show totals per sales rep and region.

A group is defined by a group key. The key is a column from the query. If the group key is a time field then user often want to group on an interval such as month or quarter.

### See Also

## header

The header band for this group.

### Description

The header band appears before the first detail row of a group. This band contains any number of sections. Sections appear sequentially one after another, or can be selected conditionally.

Report items within the header slot have visibility to the entire result set. If the header contains a simple element such as a data item, then it will display values from the first row of the group. If the header contains a chart, then the chart displays rows from the entire group. If the header displays an aggregate, then the aggregate is computed over the entire group.

In the default style, n is the group nesting level. n=1 is the topmost group, n=9 is the bottom-most group.

### See Also

## footer

The footer band for this group.

### Description

The footer band appears after the last detail row of a group. This band contains any number of sections. Sections appear sequentially one after another, or can be selected conditionally.

Report items within the footer slot have visibility to the entire result set. If the footer contains a simple element such as a data item, then it will display values from the first row of the group. If the footer contains a chart, then the chart displays rows from the entire group. If the footer displays an aggregate, then the aggregate is computed over the entire group.

In the default style, n is the group nesting level. n=1 is the topmost group, n=9 is the bottom-most group.

### See Also

## onPrepare

It is for a script startup phase. No data binding yet. The design of an element can be changed here.

### Description

It is for a script startup phase. No data binding yet. The design of an element can be changed here.