Links

Group Component

Overview

A group component is a container component where other user interface components are placed. Groups are useful when you want to combine multiple components into one. This allows for their positions and visibility to be easily altered.

Add UI Components to a Group

To add components to a group:
  1. 1.
    Drag and drop a group component onto a screen.
  2. 2.
    Drag and drop other UI components inside the group on the screen.
  3. 3.
    The added components are nested under the group in the component tree.
  4. 4.
    When a group component is moved, any UI components within it are moved with it as a unit.

Properties

Group

Property
Value
Description
Position
Relative to Screen
The group moves as the user scrolls.
Position
Relative to Device
The group stays in place as the user scrolls (suitable for creating a floating action button).
Touch Opacity
Number between 0-100
Set the group's opacity when a user clicks on the group.

Layout

Property
Value
Description
X
coordinate value
Position of the upper left corner of the button on the X-axis, where the left side of the screen is X=0.
Y
coordinate value
Position of the upper left corner of the button on the Y-axis, where the top of the screen is Y=0.
Height
number in pixels
The button's height is defined by a custom number of pixels.
Width
number in pixels
The button's width is defined by a custom number of pixels.
Resize Mode
Stretch
Stretches the group to fit the dimensions of the device's screen.
Resize Mode
Float in Place
Renders the group in the same aspect ratio as the design, regardless of the device size.

Style

Property
Value
Description
Visible
true/false
Toggle whether users can see the group.
Background Fill
color
Color of group's background.
Background Image
PNG, JPG, GIF, SVG, etc. Can also use a URL that ends in a file extension.
The image displayed in the group's background.
Background Image Resize Mode
Select from list [cover, contain, stretch, repeat, center]. See the definitions of each setting below.
Define how the group's background image is displayed if the file and the group component have different dimensions/aspect ratios.
Border Style
select from list [solid, dotted, dashed]
Style of text input's border.
Border Color
color
Color of text input's border.
Border Width
number in pixels
The width of the group's border is defined by a custom number of pixels.
Border Radius
number in pixels
The radius of the group's border’s corners is defined by a custom number of pixels.
Shadow Color
color
The group's shadow is the color selected.
Shadow Opacity
number between 0 and 100
The opacity of the group's shadow.
Shadow Radius
number in pixels
The radius of the group's shadow’s corners is defined by a custom number of pixels.
Shadow Offset
number in pixels
How far the group's shadow should be offset, in height and width, is defined by a custom number of pixels.

Picture Resize Mode

  • Center: The image is displayed at its original size within the container, and it is centered both vertically and horizontally. This means that if the image is larger than the container, parts of it may extend beyond the container's edges.
  • Cover: The image is resized to completely cover the container while maintaining its aspect ratio. This mode ensures that the entire container is filled with the image, and any excess image parts are cropped if necessary. This can result in parts of the image being clipped.
  • Contain: The image is resized to fit entirely within the container while maintaining its aspect ratio. This mode ensures that the entire image is visible within the container, and it may result in empty space around the image if the container's aspect ratio differs from the image's aspect ratio.
  • Repeat: The image is tiled or repeated to fill the entire container, both horizontally and vertically. This mode is often used for creating patterns or backgrounds that seamlessly repeat across the container.
  • Stretch: The image is resized to fully cover the container without maintaining its original aspect ratio. This can distort the image and may result in an unnatural appearance, so it's generally not recommended for most scenarios.

Group Blocks

To access the blocks specific to the group component:
  1. 1.
    On the Design tab, add a Group component to a screen.
  2. 2.
    Navigate to the Blocks tab.
  3. 3.
    In the component tree on the left, click the name of the group component.
  4. 4.
    A drawer of group-specific blocks opens.

Properties

There are two types of property blocks: dark green "set" and light green "get" blocks. The specific blocks available vary according to the UI component.
The dark green set blocks allow you to change the component's properties using blocks. For example, if you don't want a group component to be enabled for a user until they've typed a set number of characters into a text input component, you can use the group's dark green set group's disabled status block.
The light green get blocks allow you to access the properties of a component (e.g. color, font, width, text, etc.).