Add a Switch Widget
About this task
Use the Switch widget to add an on/off switch (toggle) to the app.
Procedure
- In the Canvas, open the Widgets tab.
- Double-click or drag and drop the Switch widget onto the app canvas.
- In the Switch Properties panel, enter a name for the widget in the Name field.
- Optional: Enter hint text in the Display text field indicating what the switch changes.
- In the Text Formatting section, change the default formatting settings for text.
-
Choose how you want to align your widget in the app.
- Align Left
- Center
- Align Right
- Choose whether the switch will be switched on or off by default.
- Optional:
Add a visibility rule to the widget.
Use visibility rules to control when a widget is visible to the app user. For example, you can create a condition that a widget should only appear after the app user fills in a field or submits a form.
- Select Visibility Rule to open the Set Visibility Rule dialog box.
- Select whether the visibility rule requires meeting all or any conditions.
- Select an app field or variable and an operator from the Field list. Enter the value required for the widget to be visible.
- Select Add Condition to add another condition.
- Select Save.
-
Decide which name you want to appear in the widget report.
The Same as widget name setting is the default selection and automatically uses the widget name as the chart title. To choose your own chart title, clear the option and enter a new name.
You may use special characters except for
%
&
<
>
{
}
*
|
^
and double spaces. - Move to the Format tab to customize the widget's appearance.
- Optional:
Add events and actions to the widget.
Events are activities that you can set to trigger an Action. For example, you can configure a widget to navigate to a new section in the app when the user selects it.Important: Events and actions offer a wide range of combinations. The following steps are guidelines only. Replace the listed events and actions with ones that suit your app's needs and structure. Learn more about available events and actions at Events and Actions.
-
Select Save in the SOTI Snap
banner to apply your changes.
Results
Tip: Select Preview to see how the widget
appears in your app.