XForms:User Interface Elements:Group

From MDC

Contents 1 Introduction 2 Attributes 3 Type restrictions 4 Representations 5 Example

[edit] Introduction

The group element is used as a container for defining a hierarchy of form controls. Groups can be nested to create complex hierarchies.

[edit] Attributes

• Single-Node Binding

[edit] Type restrictions

The group element can be bound to a node containing data of any type. Actually, the group element doesn't interact with the data in the bound node. However, having a relevant model item propety on the bound node has an effect on a group. All content elements (e.g. core form controls, groups, switches, repeats and host language content) within a non-relevant group are handled as non-relevant. If a group is non-relevant, then the rendering approach used to signify non-relevance is applied to the entire content of the group.

[edit] Representations

The group element doesn't have visual presentation.

[edit] Example

<group ref="address">
  <label>Shipping Address</label>
  <input ref="line_1">
    <label>Address line 1</label>
  </input>
  <input ref="line_2">
    <label>Address line 2</label>
  </input>
  <input ref="postcode">
    <label>Postcode</label>
  </input>
</group>