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:
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 ().
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:
- On the vDesigner module, see the left panel.
- In the left panel, click the Elements tab, and the Category area displays the list of elements.
- Click in the search box and then enter: Row, and the Category area displays the Row element.
- Drag the Row element to the canvas.
- 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.
|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.
The “Row” element has the following property:
- UI Configuration
- Event 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.
|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:|
|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:|
–> 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:|
In the vertical alignment, the center of the element is aligned with the top and bottom edges of the element.
|UI Properties- Alignment & Spacing||Element Alignment||Allows you to align the element in the following positions:|
|UI Properties- Alignment & Spacing||Horizontal Alignment||Allows you to align the child elements horizontally in the row layout by providing the following options:|
–> Space Evenly
–> Space Between
In the horizontal alignment, the center of the element is aligned with the right and left edges of the element.
|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.
|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)|
On the “Row” element, you can configure the following events: