Element: Switch
This element is a switch that can be toggled on or off.
Events
Switches have a mouseUp event that can be configured using low-code. This event is triggered when the user toggles the switch.
Appli treats the on and off state of a switch a true or false value.
Properties
Text Section
The properties in this section are used together with those in the appearance section to configure how the element is displayed on the screen. This section deals with the properties related to text used by the switch.
| Property | Description |
|---|---|
| textSize | The text size used in the element’s text. |
| textFont | The font used in the element’s text. |
| textStyle | The style used in the element’s text. It can be bold, italic, underlined, and strikethrough. |
| textAlign | The text alignment used for the element’s text. It can be aligned to the left, right, or center. |
Geometry Section
Use the properties in this section to configure the responsive design behaviors for the element.
| Property | Description |
|---|---|
| responsive | sets if the element size should be responsive. |
| responsiveX | how the element resizes responding to screen changes in the X axis. |
| responsiveY | how the element resizes responding to screen changes in the Y axis. |
| lockResponsiveAspectRatio | Locks the aspect ratio of the element. |
| allowUnderNotch | Stretch to fill notch |
Size Section
This section is used to configure the switch size and position.
| Property | Description |
|---|---|
| width | The value in pixels representing the distance between the left side of the element and its right side. |
| left | The value in pixels representing how distant element is from the left side of the window. |
| height | The value in pixels representing the distance between the bottom side of the element and its top side. |
| top | The value in pixels representing how far the element is from the top of the window. |
| lockAspectRatio | Locks the aspect ratio of the element. |
Appearance Section
This section is used to configure how the switch looks.
| Property | Description |
|---|---|
| blendLevel | How transparent the element is. |
| foregroundColor | The color used in text. |
| hiliteColor | The color of the hilited state of the element. |
Element Section
This section is contains properties that are specific to elements of type switch.
| Property | Description |
|---|---|
| name | The name of the element. Displayed in the project browser. |
| trueLabel | the text for the true state of the element. |
| falseLabel | the text for the false state of the element. |
| value | if the element should show a value. |
| showLabel | configures if the label is visible. |
| layout | Element-specific property that configures how it should be displayed. |
This chapter was last updated on Fri 8 May 2026 15:20:15 BST