Checkbox Row

Offers a more extended layout, where the checkbox is often accompanied by a label in a row format.

Adding a Checkbox row component

To add and use a Checkbox row component:

  • Select the Checkbox row component from the Components drawer. You can open the list of components by clicking the + button next to Components.
  • Select the Checkbox row component in the Components tree.
  • Go to the Data tab (third tab) in the Properties Panel.
  • On Label, you can change the text body of the Checkbox row. This can be set through a variable that is created under Variables modal.
2878

Just like in the Checkbox component, to manipulate the value of the Checkbox row in an API request, you will use the Screen variable mapped to its Data Source property value to send as the body of the API request action. The 'Data Source' property value is available in the third tab. By default each Checkbox row component you add has its own defined screen variable.

800

Style Properties

Style properties allow you to customize the look and feel of the component. Combinations of styles applied to components can be saved as Stylesheets to easily reuse styles throughout your app. Styles can also be set dynamically using Variables. To learn more about all the different styling properties and how they work, take a look at Intro to Styling.

Configuration Properties

NameDescription
Component nameTo alter the name of the component. The name is reflected in the Components tree. Defaults to Checkbox row.
DirectionSets the direction so that the element will appear on the left or right
Unchecked IconThe icon to show when the checkbox row status is "unchecked"
SizeSpecifies the size of the icon.
ColorColor for the button (used when the checkbox row is checked)
Unselected colorColor for the button when the checkbox row is unchecked

Data Properties

NameDescription
LabelLabel to show with the checkbox row
DisabledWhether the checkbox row is disabled
Data SourceAttach this component to a variable, or configure an initial value.

Conditional Display

You can conditionally display a component based on a given condition. Learn more about conditionally displaying components in the Conditional Display doc.

Triggers

The Checkbox row component offers several ways for you to trigger Actions when a user interacts with it in your app.

NameDescription
On PressThis Trigger will fire every time the Checkbox row is clicked/tapped and runs the associated Actions
On CheckThis Trigger will fire every time the Checkbox row's state changes to 'checked' and runs the associated Actions
On UncheckThis Trigger will fire every time the Checkbox row's state changes to 'unchecked' and runs the associated Actions