Switch

Definition

A switch is used to quickly switch between two possible states. It is commonly used for “on/off” states.

Usage

When to use

If you need to represent the switching between two states or on-off states.

Switch Configuration

For the “Switch” element, you can configure the following UI properties:

• UI Configuration
• Event Configuration

UI Configuration

Tab	Property Name	Description	Mandatory	New Default Value	Visibility Rules
Basic	Reference Name	Specifies a unique name of the element. At the application level, an element is identified and managed by the reference name.	Yes	Switch 1
Basic	Caption	Specifies the title of the element.	No	Switch
Basic	Default Value	This property allows you to define the default value of an element. To define the default value: –> Click in this box, and it displays the list of the pre-define functions, attributes, and element IDs. –> In the list, select an attribute from which the application will fetch the default value and then display it in the element.
Basic	Visible	Allows you to define the default visibility of the UI element.	No	marked
Basic	Enable	Allows the user to enable/disable an element. You can decide whether the element needs to be clickable and usable.	No	marked
Basic	Mandatory	Allows you to configure the element as a mandatory element.	No	unmarked
Basic	Message on Failure	This property becomes visible when you select Yes under Mandatory. In the Message on Failure box, enter the error message that the application will display if the user does not perform the function on the element.	No	Required	when mandatory = checked
UI Properties	Styles	Allows you to select a specific style for the element from the list of pre-defined styles. The vDesigner module offers pre-defined styles that you can apply to the element. These pre-defined styles are: –> Primary –> Secondary	No	Primary
UI Properties- Alignment & Spacing	Margin	Allows you to desirably define margin around each side of the element. It provides four different boxes to define the margin outside the right, left, top, and bottom border of the element.	No	Theme Variable (Margin)
UI Properties- Alignment & Spacing	Element Alignment	Click this list to align the element as follows: –> Right –> Top –> Bottom –> Top Right –> Top Left –> Bottom Right –> Bottom Left –> Center	No	Left Top
UI Properties- Caption	Font	Select the font type (For example: – Arial) of the element’s caption.	No	Theme Variable (Font Family)
UI Properties- Caption	Size	Enter the font size of the caption.	No	12
UI Properties- Caption	Color	Select the color of the font of the caption.	No	Theme Variable (Caption)
UI Properties- Caption	Bold	Enter the thickness of the character of the element’s caption in the range of values from 1 to 9.	No	4
UI Properties- Caption	Style	Select the style of font (For example:- Italic) of the caption	No	Normal
UI Properties- Shape & Decoration	X	Allows you to move the element along the X-axis; when the value increases, the element moves from left to right.	No	Show and Disable
UI Properties- Shape & Decoration	Y	Allows you to move the element along the Y-axis; when the value increases, the element moves from top to bottom.	No	Show and Disable
UI Properties- Select	Color	Click the Color box and then define the color of the switch when the user selects it to perform the function.	No	#FFFFFFF
UI Properties- Select	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency. While configuring the color, you can also configure the opacity in the percentage unit.	Yes	100%
UI Properties- Select	Border Color	Allows you define the color of the element’s border. To define the color: –> In the Border Color box, click the left color box (), a color canvas open. –> On the canvas, on the horizontal bar, move the circle to select the color. –> In the upper section, move the circle to select the tone of the color.	Yes	#e0e0e0
UI Properties-Select	Thumb Color	Click the Color box and then define the color of the thumb when the user selects and moves it to switch between two states.	No	Theme Variable (Primary)
UI Properties-Select	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency. While configuring the color, you can also configure the opacity in the percentage unit.	Yes	100%
UI Properties-Unselect	Color	Click the Color box and then define the color of the switch when the user does not select it to perform the function.	No	#FFFFFFF
UI Properties-Unselect	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency. While configuring the color, you can also configure the opacity in the percentage unit.	Yes	100%
UI Properties-Unselect	Thumb Color	Click the Color box and then define the color of the thumb when the user does not select the “Switch” element to switch between two states.	No	#FFFFFFF
UI Properties-Unselect	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency. While configuring the color, you can also configure the opacity in the percentage unit.	Yes	100%
Data	Entity Path	This property allows you to map an attribute to the element. You define the JSON based attributes in the entity in the Data Modeler module. To define the entity path: –> Click in the Entity Path box, and a list expands. –> The list displays several attributes from the entity. –> In the list, select an attribute to map it to the element. After the user performs the function on the element, the application can perform the following functions: a. Fetches data from the attribute and then displays it in the element. b. Stores data in the attribute.	No	EntityName.

Event Configuration

On the “Switch” element, you can configure the following event:

• onSelect