Column

This post is referring to Vahana 2 (beta version). To check the document for production, please go to vDesigner-v1.0

The “Column” element aligns multiple other elements vertically. On a page where you want to place and align multiple elements vertically, you can use the column layout.

While designing an application, you can use a column as follows:

Virtual Column

You can use the virtual column to align elements vertically on a page. When you drag an element under another element, the vDesigner module does not create the virtual column automatically. And, it has two following reasons:

  • In the vDesigner module, a page works in the default column mode
  • On the page, you can create a virtual column only after the elements’ placement has a virtual row

Let’s learn to create a virtual column through elements’ placement.

To create a virtual column:

  1. Drag an element next to another element.
  1. After you drag an element next to another element, a virtual row is created.
  1. Drag an element (For example:- Input Field) under recently added elements.
  1. After you drag the Input Field element to the canvas, drag it upward until it overlaps more than 80% of the virtual row’s area, and then release the mouse pointer.
  1. After you release the mouse pointer, the virtual column feature resizes the Input Field element and then aligns it with the Button element.

Column

Apart from seeing and using the virtual column, you can use the “Column” element from the element’s category in the vDesigner module. Like virtual column, you can also use the Column element to align several other elements vertically.

To use a column:

  1. On the vDesigner module, see the left panel.
  1. In the left panel, click the Elements tab, and the Category area displays the list of elements.
  2. Click in the search box and then enter: Column, and the Category area displays the Column element.
  1. Drag the Column element to the canvas.
  2. After you drag the Column element, the Column element appears as a real column.
  1. After you drag the Column element to the canvas, you can change its different properties in the property panel.

Aligning Elements by Using Column Element

You can use the Column element to align other vDesigner elements vertically.

To align the elements:

  1. Drag the Column element to the canvas.
  1. Drag an element (For example:- Input Field) and then place it in the Column element.
  1. Repeat step 2.
  2. After you place two input field elements in the Column element, you can see the column element successfully aligns the input fields vertically.

Usage

When to use
Use the “Column” element when you want to display items or data in the different columns of the page.

Column Configuration

The “Column” element has the following property:

  • UI Configuration
  • Event Configuration

UI Configuration

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

TabProperty NameDescriptionMandatoryNew Default ValueVisibility
Rules
BasicTypeThis property provides two options as follows:

–>Virtual:- In case of virtual column, this tab is selected by default.

When you drag the “Column” element to the canvas, the property panel displays the Virtual tab inactive. The inactive Virtual tab means that you cannot convert the column element into a virtual column after you drag it to the canvas.

–> Real:- After you drag the Column element to the canvas, the property panel displays the Real tab selected by default.

In case of a virtual column, if you click the Real tab, the virtual column is converted into a real column. Thus, the Virtual tab becomes inactive, and then you cannot change a column to a virtual column.
BasicReference NameSpecifies a unique name of the element. At the application level, an element is identified and managed by the reference name.YesColumn_XXXXX
BasicScrollableAfter 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.NoClear
BasicEnableIf you click to select this check box, the row element becomes active on the screen. You can perform the function on the active element.NoSelected
BasicVisibleIf you click to select this check box, the row element becomes visible on the screen.NoSelected
BasicWrapAfter you click this check box, the row element starts resizing its shape based on the number of elements in the row layout.NoClear
UI PropertiesStylesAllows 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.NoDefault
UI Properties-BackgroundBackgroundAllows you to configure the element?s background by providing the following options:
–> Color
–> Image
NoColor
UI Properties-BackgroundColorAllows 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#2883F3If 
?Background? 

?Color?
UI Properties-BackgroundImage SourceThis 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
NoNoneIf 
?Background? 
?Image?
UI Properties-BackgroundImage URLThis 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.NoURLIf ?Image Source? 
?URL?
UI Properties-BackgroundSelect AssetThis 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.
YesNo File SelectedIf “Image Source” = “Asset Library”
UI Properties-BackgroundElevationAllows you to configure the elevation of the background. The elevation is measured as the relative distance between two surfaces along the Z-axis.No0
UI Properties- Alignment & SpacingPadding
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.
NoTheme
Variable (Padding)
UI Properties- Alignment & SpacingMarginAllows 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.NoTheme
Variable (Margin)
UI Properties- Alignment & SpacingHorizontal AlignmentAllows you to align the child elements horizontally in the column layout by providing the following options:
–> Left
–> Center
–> Right


In the horizontal alignment, the center of the element is aligned with the right and left edges of the element.
NoLeft
UI Properties- Alignment & SpacingVertical AlignmentAllows you to align the child elements vertically in the column layout by providing the following options:
–> Top
–> Bottom
–> Center
–> Space Evenly
–> Space Around
–> Space Between


In the vertical alignment, the center of the element is aligned with the top and bottom edges of the element.
NoTop
UI Properties-Shape & DecorationTypeUnder 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.
NoAutofill
UI Properties-Shape & DecorationWidth ValueEnter the width of the element in the pixel unit or percentage unit.No
UI Properties-Shape & DecorationHeight ValueEnter the height of the element in the pixel unit.No
UI Properties-Shape & DecorationXAllows you to move the element along the X-axis; when the value increases, the element moves from left to right.NoCurrent X Co-ordinate
UI Properties-Shape & DecorationYAllows you to move the element along the Y-axis; when the value increases, the element moves from top to bottom.NoCurrent Y Co-ordinate
UI Properties-Shape & DecorationBorder RadiusAllows you to define the radius of the element?s corners. Defining the radius of the corner makes the element?s corner round.NoTheme Variable (Border Radius)

Event Configuration

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

  • onClick
Was this article helpful?
YesNo