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	Scrollable	After you click this check box, a scroll bar becomes availble in the row element. The user can move the scroll bar to view different elements in the row.	No	Clear
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	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	Visible	If this check box is selected, the row element becomes visible on the screen.	No	Selected
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	Vertical Alignment	Allows you to align the child elements vertically in the row layout by providing the following options: –> Top –> Bottom –> Center In the vertical alignment, the center of the element is aligned with the top and bottom edges of the element.	No	Top
UI Properties- Alignment & Spacing	Element Alignment	Allows you to align the element in the following positions: –> Left –> Center –> Right	No	Left
UI Properties- Alignment & Spacing	Horizontal Alignment	Allows you to align the child elements horizontally in the row layout by providing the following options: –> Left –> Center –> Right –> Space Evenly –>Space Around –> Space Between In the horizontal alignment, the center of the element is aligned with the right and left edges of the element.	No	Left
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. In the case of autofill, vDesigner places the element with the default dimensions. Manual:- If you select this option, you can change the dimensions 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