This documentation supports the 25.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)

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: 

    Property group or section

    Property name

    Description

    Example

    Spacing

    Align

    Select the alignment of the container from one of the following options: 

    • Top
    • Middle
    • Bottom

    Container_Alignment.png

    Vertical padding

    Set the vertical space between the vertical edge of the components and the vertical edge of a container by selecting one of the following options:

    • None—(0 root-em)
    • Normal—0.75 rem (12 px)
    • Airy—2 rem (32 px)
    • Custom (in root-em)

    Note: An increase in the vertical padding increases the height of the row.

    Container_vertical padding.png

    Horizontal padding

    Set the horizontal space between the components in the container and the horizontal edge of a container by selecting one of the following options:

    • None—0 root-em)
    • Normal—0.75 root-em (12 px)
    • Airy—2 root-em (32 px)
    • Custom (in root-em)

    Note: An increase in the horizontal padding might decrease the width of the component inside the row. 

    Container_Horizontal padding.png

    Space between

    Set the vertical space between the components in the container by selecting one of the following options: 

    • None—0 root-em)
    • Normal—0.75 root-em (12 px)
    • Airy—2 root-em (32 px)
    • Custom (in root-em)

    Container_space between.png

    Background and border

    Background color

    Set the background color of the container by using the color picker or adding hexadecimal or RGB values.

    Container_background color.png

    Image

    Add a background image and then set the display area, position, and size of the image.

    Comtainer_background image.png

    Border and Shadow

    Radius

    Set a value to round the corners of the container.

    Container_border and shadow.png

    Style

    Set the border style from one of the following options: 

    • Solid
    • Dotted
    • Dash

    Shadow

    Set the border shadow between a range of 1 to 5; 1 being lighter and 5 being darker. 

    Label

    Not applicable

    Specify a label for the container and set the following label properties: 

    • Alignment
    • Text color
    • Heading style
    • Weight
    • Overflow
    • Margin between the label and the component within the container

    Container_label.png

    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*