Columns Component

Overview

Use the Columns component to customize the layout of your module. The Columns component includes pre-made column designs and the ability to build custom column design layouts. Once you've added a Columns component to your module, blue Drag and Drop boxes display in your chosen column design layout. Drag and drop components into these boxes and organize them into each column.

You'll find the Columns component in the Display & Layout group to the left of the Module Builder.

About the Configuration Window

To learn more about general component settings and those that display when a component is associated with Data Models, view our General Component Settings article.

Display Panel

A static image displaying the Columns component's Display settings.

Setting

Description

Formatting

Displays a list of preset column options. Column options have preset widths using the 12 column grid Also known as the Boostrap Grid System, the 12 Column Grid system is a series of 12 invisible vertical lines that break the page into different sections. system.

Column presets include:

Column Icon Single: One 12-Unit column.

Column Icon Double: Two 6-Unit columns.

Column Icon Triple : Three 4-Unit columns.

Column Icon Quadruple: Four 3-Unit columns.

Column Icon Double Small-Left: One 3-Unit and one 9 Unit column.

Column Icon Double Small-Right: One 9-Unit and one 3-Unit column.

Column Icon Triple Wide-Center: One 2-Unit, one 8-Unit, and one 2-Unit column.

Column Icon Triple Gutter Sides: One 1-Unit, one 10-Unit, and one 1-Unit column.

Column Icon Customize Columns: Use a custom column layout.

If the preset options do not meet your needs, create your own using the Column Icon Customize Columns button.

By default, the Columns component is set to the Double column setting.

Disable All Nested Fields

When set to  (ON), all components placed inside the columns are disabled. Use this setting instead of disabling each component.

By default, this toggle is set to (OFF).

Hide All Nested Fields

When set to  (ON), all components inside the columns are hidden from the end-user End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.. Use this setting instead of hiding each component.

By default, this toggle is set to (OFF).

Customize Columns

Click the Column Icon Customize Columns button to create your own column layout. The Column component uses the 12 column grid Also known as the Boostrap Grid System, the 12 Column Grid system is a series of 12 invisible vertical lines that break the page into different sections. system to organize and position columns on the page. Customizing the column layout lets use set column widths, and push or move columns within the 12 grid system.

A static image displaying the Column component's Customize Columns setting.

Setting

Description

Column

Each row represents the individual columns. Each column can be adjusted using the column attribute fields.

Width

The total width of the column. Your module has a total width of 12 units. For example, you could create 12 columns at a width of one unit each, or you could create two columns at a width of six units each.

Push Right

Moves all columns to the right by a specified number of units. If you push a column beyond the available width, a new row of columns starts

Move Right

Moves the individual column to the right by a specified number of units without moving the other columns. If you move one column into another column, the columns overlap.

Move Left

Moves the individual column to the left by a specified number of units without moving the other columns. If you move one column into another column, the columns overlap.

Delete

Permanently deletes the Column row.

Add New Row

Adds a new Column row to the bottom of the table.

Advanced Panel

Additional Styling

A static image displaying the Columns Component's Advanced settings.

Setting

Description

Custom CSS Class

Enter a Custom CSS Cascading Style Sheets (CSS) is a style sheet language used for presenting how a HTML or XML document looks to end-users. Class to apply to your component. Custom CSS lets you maintain a consistent look and feel when the field or element is part of a template or multiple modules.

Updated CSS styling applies to all components that reference this custom class name.

Adding a Columns Component

In this example, you'll set up three evenly-spaced columns with three Text Field components for your end-user End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. to submit their first, middle, and last names.

Configure the Columns Component

This component divides your module into three evenly-spaced columns.

1. In the Module Builder, drag and drop a Columns Component Icon Columns component onto your canvas.
2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module.  field, enter colDetails.
3. Under Formatting, click the Column Icon (Triple) Button.

A static image displaying the Columns Component's Display settings, the Three Column button is selected.

4. Click Save Component.

Configure the Text Field Components

Here you'll configure three Text Field components associated with your First Name, Middle Name, and Last Name fields.

1. Drag a  Text Field component onto your canvas, placing it in column1 of the colDetails Columns Component Icon Columns component.

2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter firstName.
3. In the Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. field, enter First Name.
4. Click Save Component.
5. Repeat this process with two more  Text Field components, placing them in column2 and column3 of the colDetails Columns Component Icon Columns component.
6. Enter the following Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. and Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. values for the two  Text Field components:

Property ID

Label Text

middleName

Middle Name

lastName

Last Name

A static image displaying the Module Builder canvas, the Columns component contains three text fields, one in each column.

7. Click Save Component.
8. Save your module.

Your module looks like the following in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.:

Resources

Overview

Use the Columns component to customize the layout of your module. The Columns component includes pre-made column designs and the ability to build custom column design layouts. Once you've added a Columns component to your module, blue Drag and Drop boxes display in your chosen column design layout. Drag and drop components into these boxes and organize them into each column.

You'll find the Columns component in the Display & Layout group to the left of the Module Builder.

About the Configuration Window

To learn more about general component settings and those that display when a component is associated with Data Models, view our General Component Settings article.

Display Panel

A static image dispaying the Columns component's Display settings.

Setting

Description

Formatting

Displays a list of preset column options. Column options have preset widths using the 12 column grid Also known as the Boostrap Grid System, the 12 Column Grid system is a series of 12 invisible vertical lines that break the page into different sections. system.

Column presets include:

Column Icon Single: One 12-Unit column.

Column Icon Double: Two 6-Unit columns.

Column Icon Triple : Three 4-Unit columns.

Column Icon Quadruple: Four 3-Unit columns.

Column Icon Double Small-Left: One 3-Unit and one 9 Unit column.

Column Icon Double Small-Right: One 9-Unit and one 3-Unit column.

Column Icon Triple Wide-Center: One 2-Unit, one 8-Unit, and one 2-Unit column.

Column Icon Triple Gutter Sides: One 1-Unit, one 10-Unit, and one 1-Unit column.

Column Icon Customize Columns: Use a custom column layout.

If the preset options do not meet your needs, create your own using the Column Icon Customize Columns button.

By default, the Columns component is set to the Double column setting.

Disable All Nested Fields

When set to  (ON), all components placed inside the columns are disabled. Use this setting instead of disabling each component.

By default, this toggle is set to (OFF).

Hide All Nested Fields

When set to  (ON), all components inside the columns are hidden from the end-user End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.. Use this setting instead of hiding each component.

By default, this toggle is set to (OFF).

Customize Columns

A static image displaying the Columns component Display settings, the Customize Columns button is selected and the Customize Columns table is displayed.

Setting

Description

Col1/Col2/...

The individual columns. Each column can be adjusted using the Column Attribute fields. To add or remove a column, mouse over an existing column to reveal the ··· (Settings) button.

The ··· (settings) button contains the following column settings:

  • Insert Column: Adds a column to the right side of the table.

  • Delete Column: Deletes the selected column.

Column Attribute

The Column Attribute rows define the size and position of each column.

Width

The total width of the column. Your module has a total width of 12 units. For example, you could create 12 columns at a width of one unit each, or you could create two columns at a width of six units each.

Push Right

Moves all columns to the right by a specified number of units. If you push a column beyond the available width, a new row of columns begins.

Move Right

Moves the individual column to the right by a specified number of units without moving the other columns. If you move one column into another column, the columns overlap.

Move Left

Moves the individual column to the left by a specified number of units without moving the other columns. If you move one column into another column, the columns overlap.

Advanced Panel

A static image dispaying the Columns component's Advanced settings.

Additional Styling

Setting

Description

Custom CSS Class

Enter a Custom CSS Cascading Style Sheets (CSS) is a style sheet language used for presenting how a HTML or XML document looks to end-users. Class to apply to your component. Custom CSS lets you maintain a consistent look and feel when the field or element is part of a template or multiple modules.

Updated CSS styling applies to all components that reference this custom class name.

Adding a Columns Component

In this example, you'll set up three evenly-spaced columns with three Text Field components for your end-user End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. to submit their first, middle, and last names.

These instructions assume that you have an open module saved and with a title.

Configure the Columns Component

This component divides your module into three evenly-spaced columns.

1. In the Module Builder, drag and drop a Columns Component Icon Columns component onto your canvas.
2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module.  field, enter colDetails.
3. Under Formatting, click Three Columns Icon(three columns).

A static image displaying the Columns Component's Display settings, the Three Column button is selected.

4. Click Save & Close.

Configure the Text Field Components

Next, you'll configure three Text Field components so you end-user can enter the first, middle, and last names.

1. Drag a  Text Field component onto your canvas, placing it in column1 of the colDetails Columns Component Icon Columns component.

2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter firstName.
3. In the Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. field, enter First Name.
4. Click Save & Close.
5. Repeat this process with two more  Text Field components, placing them in column2 and column3 of the colDetails Columns Component Icon Columns component.
6. Enter the following Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. and Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. values for the two  Text Field components:

Property ID

Label Text

middleName

Middle Name

lastName

Last Name

A static image displaying the Module Builder canvas, the Columns component contains three text fields, one in each column.

7. Click Save & Close.
8. Save your module.

Your module looks like the following in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.:

Resources