Row

The “Row” element is used to align other elements (For example:- button, image, icon, etc) horizontally. In a page that contains multiple UI (User Interface) items, the “Row” element proves of high importance to align multiple user interfaces horizontally.

You use multiple row layouts to align user interfaces horizontally. You can view the “Row” element in the following ways:

Virtual Row

When you drag an element next to another element on the canvas, the vDesigner module creates a virtual row around the elements. To view and observe the virtual row, you need to put the mouse pointer close to the element’s edge, and then the virtual row’s layout becomes visible. The layout encloses the elements’ edges and helps you align the elements horizontally.

To view the background of the virtual row, see the vDesigner toolbar and then click the Layout Toggle icon ().

Row

Apart from seeing and using the virtual row, you can use the “Row” element from the element’s category in the vDesigner module. To use the row:

1. On the vDesigner module, see the left panel.

2. In the left panel, click the Elements tab, and the Category area displays the list of elements.
3. Click in the search box and then enter: Row, and the Category area displays the Row element.

4. Drag the Row element to the canvas.
5. After you drag the Row element to the canvas, the element appears on the canvas as a real row.

After you drag the Row element to the canvas, you can configure its properties. You can also place other elements in a row. When you drag a row to the canvas, you cannot change its state from Real to Virtual.

Usage

When to Use

Use the “Row” element: –> When you want to align mulitple elements horizontally in a single page. –> When you want to neatly group multiple elements in a section or under a specific area.

Row Configuration

The “Row” element has the following property:

• UI Configuration
• Event Configuration

UI Configuration

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

Tab	Property Name	Description	Mandatory	New Default Value	Visibility Rules
Basic	Type	This property provides two options as follows: –>Virtual:- In case of virtual row, this tab is selected by default. When you drag the “Row” element to the canvas, the property panel displays the Virtual tab inactive. The inactive Virtual tab means that you cannot convert the row element into a virtual row after you drag it to the canvas. –> Real:- After you drag the Row element to the canvas, the property panel displays the Real tab selected by default. In case of a virtual row, if you click the Real tab, the virtual row is converted into a real row. Thus, the Virtual tab becomes inactive, and then you cannot change a row to a virtual row.	No	Real
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	Row_xxxxx
Basic	Enable	If this check box is selected, the row element becomes active on the screen. You can perform the function on the active element.	No	Selected
Basic	Business Rule	Click this list and then select a business rule to make the element active or inactive. If the user’s action satisfies the condition in the business rule, the application will make the element active or inactive in the application. To define the business rule, access the Business Rule Manager module.	No
Basic	Wrap	After you click this check box, the row element starts resizing its shape based on the number of elements in the row layout.	No	Clear
Basic	Scroll	Click this check box to make the scroll bar available in the element.	No	Clear
Basic	Visible	If this check box is selected, the row element becomes visible on the screen.	No	Selected
Basic	Business Rule	Click this list and then select a pre-defined business rule that will determine the element’s visibility. If the user’s action satisfies the condition in the business rule, the application will display or hide the element. To define the business rule, access the Business Rule Manager module.	No
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.	No	Default
UI Properties-Background	Background	Allows you to configure the element’s background by providing the following options: –> Color –> Image	No	Color
UI Properties-Background	Color	Allows you to configure the background color of the element. To configure the background color: –> In the Background Color box, click the left color box (), and 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.	No	#2883F3	If “Background” = “Color”
UI Properties-Background	Image Source	This box becomes visible after you click the Image tab. To configure an image as the element’s background, you can use one of the following options: –> None –> URL –> Asset Library	No	None	If “Background” = “Image”
UI Properties-Background	Image URL	This box becomes visible after you select URL in the Image Source list. In the Image URL box, enter the URL of an image. The application fetches the image from the URL-based location and then displays it as the element’s background.	Yes	“URL Path”	If “Image Source” = “URL”
UI Properties-Background	Select Asset	This box becomes visible after you select Assets Library in the Image Source list. This property allows you to configure an image as the element?s background from the Assets Manager module. To configure the image: –> Click the asset library icon (), and the Select Asset dialog box opens. –> In the Select Asset dialog box, select an image and then click Select, and you successfully configure the image as the element’s background.	Yes	No File Selected	If “Image Source” = “Asset Library”
UI Properties-Background	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	0
UI Properties- Alignment & Spacing	Padding	Allows you to desirably define padding around each side of the element. It provides four different boxes to define the padding around the right, left, top, and bottom side of the element.	No	Theme Variable (Padding)
UI Properties- Alignment & Spacing	Margin	Allows you to define a margin around each side of the element. It provides four different boxes to define the margin outside the right, left, top, and bottom borders of the element.	No	Theme Variable (Margin)
UI Properties- Alignment & Spacing	Element’s Alignment	This property contains three tabs. You can use these tabs as follows: 1. Left:- By default, this tab is selected. It aligns the element to the left of the page. 2. Center:- If you select this tab, it aligns the element at the center of the page. 3. Right:- If you select this tab, it aligns the element to the right of the page.	No	Left
UI Properties- Alignment & Spacing	Container Internal Alignment	This property offers the following alignment options to align an element in a container element. 1. First List:- It provides the following alignment options: a. Left b. Center c. Right 2. Second List:- It provides the following alignment options: a. Top b. Middle c. Bottom d. Space Around e. Space Between f. Space Evenly	No	Left, Top
UI Properties- Shape & Decoration	Type	Under the Shape and Decoration section, this property has the two following options: Autofill:- If you select this option, the element will occupy the available space of the parent layout. Manual:- If you select this option, you can define a specific size of the element.	No	Autofill
UI Properties- Shape & Decoration	Width Value	Enter the width of the element in the pixel unit or percentage unit.	No
UI Properties- Shape & Decoration	Height Value	Enter the height of the element in the pixel unit.	No
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	Current X Co-ordinate
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	Current Y Co-ordinate
UI Properties- Shape & Decoration	Border Radius	Allows you to define the radius of the element’s corners. Defining the radius of the corner makes the element’s corner round.	No	Theme Variable (Border Radius)

Event Configuration

On the “Row” element, you can configure the following events:

• onClick