apache > cocoon

- Home

# Group/Struct widget

## Concept

A group widget is simply a container for a number of other widgets. This can be useful to:

- change the state of the grouped widgets as a whole
- to use in a union widget
- ....

The group widget was previously called struct.

## Definition

    <fd:group id="..." state="...">
      <fd:widgets>
        [...]
      </fd:widgets>
      <fd:validation>
         [...]
      </fd:validation>
      <fd:on-create>
         [...]
      </fd:on-create>
      <fd:attributes>
        <fd:attribute name="..." value="..."/>
      </fd:attributes>
    </fd:group>

## Template

A group widget is inserted in a template using the ft:group tag. The content of the ft:group widget is the template for the children of the group widget, thus should contain the template tags for these child widgets.

    <ft:group id="...">
      [...]
    </ft:group>

### Example

For a definition like this:

    <fd:group id="mygroup">
      <fd:widgets>
        <fd:field id="field1"/>
        <fd:field id="field2"/>
      </fd:widgets>
    </fd:group>

The template could look like this:

    <ft:group id="mygroup">
      <ft:widget id="field1"/>
      <br/>
      <ft:widget id="field2"/>
    </ft:group>

## Styling (default HTML XSL)

N/A

Errors and Improvements? If you see any errors or potential improvements in this document please help us: View, Edit or comment on the latest development version (registration required).