Apache » Cocoon »

The Apache Cocoon Project

# Cocoon Forms 1.0

- Cocoon 2.2
- Core 2.2
- Blocks 2.2
- Maven Plugins 2.2
- Subprojects

# 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).