Columns Component

Prev Next

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 Settings

Default State Options

Setting

Description

Disable All Nested Fields                                                                        

When set to A toggle switch indicating an on/off state for a user interface element. (ON), all components placed inside the columns are disabled. Use this setting instead of disabling each component.

By default, this toggle is set to A toggle switch in the 'on' position, indicating an active setting or feature. (OFF).

Hide All Nested Fields                                                                        

When set to A toggle switch indicating an on/off state for a user interface element. (ON), all components inside the columns  are hidden from the end-user. Use this setting instead of hiding each component.

By default, this toggle is set to A toggle switch in the 'on' position, indicating an active setting or feature. (OFF).

Formatting                                                                        

Displays a list of preset column options based on a 12 column grid 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.

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

Customize Columns

Click the Column Icon Customize Columns button to create your own column layout. The Column component uses the 12 column grid 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 Settings

Additional Styling

Setting

Description

Custom CSS Class                                                                        

Enter a Custom CSS 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.

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

Accessibility Settings

ARIA

Setting

Description

Aria                                                                        

Use these settings to create ARIA (Accessible Rich Internet Applications) attributes to better support end-users that require screen readers to navigate your applications.

Aria Label                                                                            

Use this field to define the component when when a screen reader arrives at it in Express View.

Aria Role                                                                            

ARIA roles provide semantic meaning to content, letting screen readers and other accessibility tools present and support interaction with an element  that is consistent with end-user expectations. ARIA roles are used to describe elements that do not exist in HTML or not supported by the browser.

To learn about supported ARIA roles in Unqork, view our ARIA Accessibility Settings reference guide.

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

Adding a Columns Component

In this example, you'll set up three evenly-spaced columns with three Text Field components for your end-user 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  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 field, enter firstName.

  3. In the Label Text 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 and Label Text 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:

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 based on a 12 column grid 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 A toggle switch indicating an on/off state for a user interface element. (ON), all components placed inside the columns are disabled. Use this setting instead of disabling each component.

By default, this toggle is set to A toggle switch in the 'on' position, indicating an active setting or feature. (OFF).

Hide All Nested Fields                                                                        

When set to A toggle switch indicating an on/off state for a user interface element. (ON), all components inside the columns  are hidden from the end-user. Use this setting instead of hiding each component.

By default, this toggle is set to A toggle switch in the 'on' position, indicating an active setting or feature. (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 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.

Accessibility Panel

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

ARIA

Setting

Description

Aria                                                                        

Use these settings to create ARIA attributes to better support end-users that require screen readers to navigate your applications.

Aria Label                                                                            

Use this field to define the component when when a screen reader arrives at it in Express View.

Aria Role                                                                            

ARIA roles provide semantic meaning to content, letting screen readers and other accessibility tools present and support interaction with an element  that is consistent with end-user expectations. ARIA roles are used to describe elements that do not exist in HTML or not supported by the browser.

To learn about supported ARIA roles in Unqork, view our ARIA Accessibility Settings reference guide.

Adding a Columns Component

In this example, you'll set up three evenly-spaced columns with three Text Field components for your end-user 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  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 field, enter firstName.

  3. In the Label Text 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 and Label Text 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:

Resources