Switch Group control

Switch Group is used to select one or more options from the given list of choices. It is a small interactive box that can be toggled by the user to indicate an affirmative or negative choice. A user can toggle on/off multiple values in Switch Group control.

UI Properties

Info

  • Unique Name: A Unique Name is used to uniquely identify a control in your App. Every control that is added on the screen gets an auto-generated Unique Name on the basis of the Label name given to the control.

  • Label: The text that is displayed helps the user to understand the type of control it represents.

  • Tooltip: The option to add tooltip text as a hint to the user. It is visible when you switch on the visibility toggle property.

  • Description: The option to provide a description that you can add for your control. It is visible when you switch on the visibility toggle property.

  • External CSS: With this property, one can imply exclusive CSS on controls. You can customize your control with CSS by selecting the correct class or id of the control. You can read more here.

  • Caching: When the caching option is selected and if a LOOKUP formula is applied to this control, the value that the LOOKUP returns will be cached and the user will be able to see this value in the fields even when he accesses the microapp later with no connectivity. This option is required when you want your app to be accessible in offline mode as well and getting the latest data from the sheets is not always critical.

  • Hidden: The hidden option helps to hide control from the user. This helps when you don’t want the user to view the control.

  • Trigger Dependents: When you Disable Trigger Dependents, it helps you to reduce or optimize the unnecessary evaluation of the dependent control’s formula. For a detailed explanation refer to this article here. By default, Trigger dependents are enabled. However, in complex apps by switching it off, you would limit the evaluation in the dependent control and in turn ensure quicker response times.

  • Hide on desktop: This option hides the selected control in the desktop view.

  • Hide on Mobile: This option hides the selected control in the mobile view.

  • Dynamic Height: This option dynamically increases /decreases the height of the text control based on the given content.

  • Maintain space when hidden: This option maintains the specified space between controls when a particular control is hidden. When control is hidden the space is maintained in the preceding control depending on the space the previous control has occupied.

Note: Hide on desktop, Hide on Mobile, Dynamic Height and Maintain space when hidden are
available in Basic Freeflow Editor Only.

Properties

property

Under this section, we get a few options related to formatting our switch.

  • Theme Toggle on: Here the user can set the theme color of the switch when it is Toggled On.

  • Theme Toggle off: Here the user can set the theme color of the switch when it is Toggled Off.

  • Bead color: Here the user can set the theme color of the beads in the switch toggle buttons.

    format

    result

How to use Switch Group control

Select Switch Group under Custom section from Controls.

Bind data to Switch Group control

We get two options while binding data to the switch group control:

  1. Option: To specify the data being available as options for toggle on/off in the Switch Group control.

  2. Selected Options: To specify the data which we want to be toggled on by default, in the Switch Group Control.

In the above image, the data has been bound to the Options as well as Selected Options.

We can bind data through different options present in the BIND data section, such as sheets, controls, connectors, variables, and more.

The data bind format and output format for switch group control is an array.

Add Action to Switch Group control

event

value_select :

This is when there is a change in the value of the respective control namely by clicking another option.

On the action of toggle, we get the toggled-on values from the event in an array type of data. To view, we have applied the event on toast action. We have selected the switchgroup keyword for the toast message.

On click of toggle-on of the values, we are getting toast message of the respective values in array data type.

data type

Switch Group control preview