Repeat

   MaestroThe UI design product.  |   Form Builder |  All versions This feature is related to all versions.

Maestro provides the Repeat component (widget), which is a container for other components, such as text fields and labels, that allows a form user to add the whole repeating component multiple times to a form, by clicking a Repeat Add Button. This is especially handy when adding another customer's name or address field to a form.

Repeats are handy for creating data structures using Data Field components, so you can organize application-specific data but have no visual representation in a form. A typical example is shown below:

  1. Parent repeat component
  2. Data field of the parent repeat
  3. Child repeat component
  4. Data field of the child repeat

Usage

  1. Open the Palette pane in the Maestro Editor.
  2. Locate the Repeat component within the Repeats folder.
  3. Drag the component into the View pane or the Wireframe.
  4. Configure the component's properties via the Properties pane.

Properties

The following properties are available to the Repeat component:

Repeat Item Label
Text
itemLabel

Can be used on multiple references, such as add and delete buttons

Initial Items In Repeat
Integer
initialItems

Enter the initial number of items in repeat

Min Items In Repeat
Integer
minItems

Enter the minimum number of items allowed in repeat

Max Items In Repeat
Integer
maxItems

Enter the maximum number of items allowed in repeat. Set to 0 for unrestricted

Transfer Focus To New Instance
Boolean
transferFocus

Transfers the focus to the first field in new instance

Transfer Focus After Delete
Boolean
transferFocusAfterDelete

Transfers the focus to the previous instance

Linked Delete Button To Focus
Field Ref
linkedDeleteButton

Link the delete button which will get focused to when deleted. For example, data.repeatDeleteButton.

Linked Add Button To Focus
Field Ref
linkedAddButton

Link the add button which will get focused to when deleted if no instances remain. For example, data.repeatAddButton.

Button Options

Add Button Label
Rich Text
addItemLabel

Used on Add button

Show Add Button
Boolean
showAddButton

Check to show the add button.

Add Item Icon
Icon
addButtonIcon

Used on Add button

Hide Add Button when Max Reached
Boolean
hideAddButtonOnMax

Check to hide the add item button when item max is reached

Hide Delete Button when Min Reached
Boolean
hideDeleteButtonOnMin

Check to hide the delete item button when item min is reached

Next, learn about the Repeating Block Template component.