The floating action button is used to access the most common functionalities or actions on the screen. It appears as a circular shape icon by default.
|When to use||When not to use|
|Use the FAB if it is suitable to present the primary functions of the current screen. Only include most primary functions in the FAB. Use two different FAB(s) if they denote distinct primary functions/actions.||Do not use multiple FAB(s) on the specific screen. Do not use FAB on every screen especially if the images denote the primary functions on the screen.|
Floating Action Button Configuration
On the “Floating Action Button” element, you can perform the following configurations:
- UI Configuration
- Event Configuration
For the “FAB” element, you can configure the following UI properties:
|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||Fab_1|
|Basic||Source||Allows you to configure the source location of the element’s image. The application fetches the element’s image from the source location and displays it to the user. You can use the following options to configure the source location:|
–> Asset Library
|Basic||Enter URL||This box appears after you select URL in the Source list. In the Enter URL box, enter the URL of the image, and the application loads the image from the source location.||Yes||if source = url|
|Basic||Select Asset||It allows you to fetch the element’s image from the Assets Manager module. In this box:|
–> Click the asset library icon (), and the Select Asset dialog box opens.
–> In the Select Asset dialog box, select an icon, and then click Select, and you successfully configure the image of the icon.
|Yes||if source = Assets|
|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|
|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 styles are:|
|UI Properties||Color||Click the Color box and then select the background color of the button.||No||Theme Variable (Primary)|
|UI Properties||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.
|UI Properties||Elevation||Allows you to configure the elevation of the background. The elevation is measured as the relative distance between two surfaces along the Z-axis.||No||8|
|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||Allows the user to set the position of the text within the element. You can use any of the following options for positioning the text:|
–> Top Right
–> Top Left
–> Bottom Right
–> Bottom Left
|UI Properties-Icon||Size||Allows you to configure the size of the element’s icon in the pixel unit.|
|UI Properties-Icon||Color||Allows you to configure the color of the element’s icon. To configure the color:|
–> In the 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.
|UI Properties- Shape & Decoration||Type||Under the Shape and Decoration section, this property has the two following options:|
Autofill:- If you select this option, you cannot change the element’s dimensions. When you drag the element to the canvas, this option is selected by default.
If you select Auto Fill, vDesigner places the element with the default dimensions.
Manual:- If you select this option, you can change the dimensions of the element.
|UI Properties- Shape & Decoration||Width Value||Enter the width of the element in the pixel unit or percentage unit.||No||56px|
|UI Properties- Shape & Decoration||Height Value||Enter the height of the element in the pixel unit.||No||56px|
|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 & 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 & Disable|
|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.
You can configure the following event on the ?Fab Button? element: