This documentation supports the 23.3 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.To view an earlier version, select the version from the Product version menu.

Designing page layouts with rows and columns


Rows and columns are horizontal and vertical containers within which you arrange page components. As an administrator, by using rows and columns, you can create a grid-based page design that helps maintain proportion and alignment between elements.

Arranging components in rows and columns provides the following benefits: 

  • Creates a good balance by using text, images, and white space on the web page. 
  • Makes it easier for end users to understand the content hierarchy by grouping related elements together.  
  • Multicolumn layouts help you to display different types of content next to each other.
    For example you can display text alongside images that creates a visually appealing page layout. 

As an administrator, you design a page by arranging components in rows and columns to create advanced and engaging page layouts with a combination of rows and columns.

Example of page design with rows and columns


Example_page layout with rows and columns.png


Adding and customizing rows

A row is automatically added after you add any component to the page. 

You can add background images to make rows visually engaging or use a background color to create contrast. You can nest components within a row and provide context for the text in the component. Row properties override properties that you configure at the page level.

To learn how to customize a row, see Customizing-the-appearance-of-a-row.

Restrictions for using page components in rows

The total width of all components in a row is restricted to 100%, which is the full width of a page. Each page component has a specified minimum width, expressed as a percentage of the full page width (100%). For example, the minimum width allowed for the container is 10%. When you add multiple page components in a single row (horizontally), you must consider the total sum of the components' minimum widths to comply with the designated 100% width limit of the row. 

Important

This limit does not apply when you add components to a column (vertically).

The following table describes the minimum width allowed for each component:

Component

Minimum width allowed

Container

10%

Content block

10%

Catalog section

25%

Catalog banner

100% (fits across the full width of the page)

Events

100% (fits across the full width of the page)

Record view

33%

Asset group

25%

Search bar (standalone)

(Version 23.3.01 and later) 25%

Example

The maximum number of components that you can add in a row depends on the minimum width of each component. For example, to comply with the total width limit of the row, you can add four search bars (standalone) in a single row, or you can add one search bar (standalone) and seven containers. 

The following image illustrates this example: 

sample_layout.png


Adding and customizing columns

Containers allow you to create columns and organize multiple components within them. You can add a background image to make columns visually engaging or add a background color to create contrast. 

Behavior and restrictions of the Container component

Be aware of the following behavior and restrictions when arranging components in a column:

  • You cannot configure the height of a container. It takes the full height of the row in which it nests.
  • If a container is empty (no component is added to it), in the end user view, the space occupied by the container is not rendered.

    Example of how an empty container is displayed in the end user view

    Example_empty container.png

  • If a container is the only component in the parent row, it occupies the area of the content within it. 

    Example of a container resized to occupy the content within

    Example_container resized.png


To configure the Container component for columns

You add the Container component to the page to be able to stack components in a column. 

  1. Log in to the Admin console and select Configuration Studio
  2. Create or open a studio page that you want to design. 
  3. Click Components Components icon in Studio.png.
  4. Drag the Container component to the page canvas. 
  5. On the  Container Properties image2022-9-21_15-33-55.png tab, configure the following properties: 

You have configured the container component. You can now add other components and arrange them vertically within this container. 


To arrange components within a container

After configuring the container, you add and arrange components in the container. 

  1. Log in to the Admin console and select Configuration Studio
  2. Create or open a studio page that you want to design. 
  3. Click Components Components icon in Studio.png.
  4. Drag a component and position it within the container. 
    The following table provides options for how you can position a component in the container: 

    Position

    Example of placing the content block

    In the top row of the container

    Container_content block in top row.png

    In a column of the container

    Container_content block in a column.png

    In a new row within the container

    Container_content block in a nested row inside a container.png

  5. Configure the component; see Creating-pages-in-the-studio.
  6. Save the page. 


Tip

If you have multiple layers or nested components on a page, to configure the exact layer, we recommend that you right click the canvas to open the Layers menu and select the options. Only the supported options are displayed in this menu.

The following image shows the Layers menu and the submenu: 

Container_layers context menu.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*