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
BasicBusiness RuleClick 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
BasicVisibleIf you click to select this check box, the row element becomes visible on the screen.NoSelected
BasicBusiness RuleClick 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
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 & SpacingElement’s AlignmentThis 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.
NoLeft
UI Properties- Alignment & SpacingContainer Internal AlignmentThis 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
NoTop, Left
UI Properties-Shape & DecorationTypeUnder 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.
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