Page Content Layouts

Layout types

A layout sets the container's minimum and maximum width and position on the page. To support various page content requirements, we provide the following layout types:

Narrow

A narrow layout consists of a single-column with a constrained width size.

To implement a narrow layout, use the <PageContentNarrow> component.

import { PageContentNarrow } from '@commercetools-frontend/application-components';

const ChannelsDetails = () => {
  // ...
  return (
    <PageContentNarrow>
      <Spacings.Stack>
        <div>Title</div>
        <ChannelsForm />
      </Spacings.Stack>
    </PageContentNarrow>
  )
};

Best practices

• Use a narrow layout for simple forms where form fields must span across the available width (horizontalConstraint: scale).
• Avoid a narrow layout for complex forms and tables.

Wide (single column)

A wide layout consists of a single column with a constrained width size, wider than a narrow layout.

To implement a wide (single column) layout, use the <PageContentWide> component.

import { PageContentWide } from '@commercetools-frontend/application-components';

const ChannelsDetails = () => {
  // ...
  return (
    <PageContentWide>
      <Spacings.Stack>
        <div>Title</div>
        <ChannelsForm />
      </Spacings.Stack>
    </PageContentWide>
  )
};

Best practices

• Use a wide layout for content where more space is necessary but does not require the full page width.
• Depending on the type of content, consider also using a horizontalConstraint: 15 to limit the width, for example, with form fields.
• Avoid a wide layout for large tables.

Wide (two columns: 1/1)

This variation of the wide layout consists of two columns of equal sizes.

To implement a wide layout with two columns (1/1), use the <PageContentWide> component with the columns property set to 1/1.

import { PageContentWide } from '@commercetools-frontend/application-components';

const ChannelsDetails = () => {
  // ...
  return (
    <PageContentWide columns="1/1">
      <div>Left side</div>
      <div>Right side</div>
    </PageContentWide>
  )
};

Best practices

• Use a wide layout with two columns for displaying information next to each other to save vertical space.
• Group the content of each column to indicate to the user that they should view the content vertically.
• Avoid horizontal constraints. Instead, let the content span across the available width.
• Avoid this layout for tables and forms.

Wide (two columns: 2/1)

This variation of the wide layout consists of two columns of different sizes, with the left column being wider than the right.

To implement a wide layout with two columns (2/1), use the <PageContentWide> component with the columns property set to 2/1.

import { PageContentWide } from '@commercetools-frontend/application-components';

const ChannelsDetails = () => {
  // ...
  return (
    <PageContentWide columns="2/1">
      <Spacings.Stack>
        <ChannelsForm />
      </Spacings.Stack>
      <Spacings.Stack>
        <div>Meta info</div>
      </Spacings.Stack>
    </PageContentWide>
  )
};

Best practices

• Use the left column to render forms where form fields must span across the available width (horizontalConstraint: scale).
• Use the right column to display general information or links about the page, such as meta dates or links to other resources, because the column is sticky on scroll.
• Avoid this layout for tables.

Full

A full layout consists of a container that spans across the width of the page.

To implement a full layout, use the <PageContentFull> component.

import { PageContentFull } from '@commercetools-frontend/application-components';

const Channels = () => {
  // ...
  return (
    <PageContentFull>
      <ChannelsTable />
    </PageContentFull>
  )
};

Best practices

• Group the content so that the reading flow is clear and the user can scan through the page easily.
• Use this layout for horizontally grouped content.
• Avoid using this layout for forms.

Layout combinations

You can combine up to two different layout types on the same page. We support the following layout combinations:

• Narrow + wide (single column)

  

• Narrow + full

  

• Wide (two columns: 1/1) + wide

  

• Wide (two columns: 2/1) + wide

  

• Wide (two columns: 2/1) + wide (two columns: 1/1) + full

  

• Wide + full + wide (two columns: 2/1)

  

Caveats

For example, the following layout combinations won't work: