Grid
Ready

Grid component provides structure for other components using Flexbox based layout system. Grid allows nesting and defining the direction of the content.

While the Grid Item component makes it possible set additional parameters for Grid’s cells, this component can be used without <duet-grid-item/> as well. In that case the direct child elements of Grid will be considered as Grid cells.

Examples

Select an example

Open in new window

<duet-grid responsive class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive distribution="center" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive distribution="right" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive distribution="space-between" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive distribution="space-around" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive distribution="space-evenly" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="top" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="center" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="bottom" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="stretch" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="baseline" class="grid-demo">
  <duet-grid-item
    ><div style="line-height: 1.2">Grid Item<br />with multiple<br />rows of text.</div></duet-grid-item
  >
  <duet-grid-item><div style="line-height: 7">Grid Item</div></duet-grid-item>
  <duet-grid-item><div style="line-height: 3">Grid Item</div></duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="stretch" class="grid-demo">
  <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="stretch" class="grid-demo">
  <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item min-width="300px">Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="stretch" class="grid-demo">
  <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive direction="vertical" class="grid-demo">
  <duet-grid-item>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-grid responsive alignment="stretch" class="grid-demo">
  <duet-grid-item fill>
    <duet-grid responsive alignment="stretch">
      <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
      <duet-grid-item fill>Grid Item</duet-grid-item>
      <duet-grid-item fill>Grid Item</duet-grid-item>
    </duet-grid>
  </duet-grid-item>
  <duet-grid-item>Grid Item</duet-grid-item>
</duet-grid>

Open in new window

<duet-layout center margin="none">
  <div slot="main">
    <duet-card padding="large" margin="none">
      <div>
        <duet-choice-group value="one" label="Asiointikieli" direction="horizontal" name="group" responsive>
          <duet-choice label="Suomi" type="radio" value="one" expand></duet-choice>
          <duet-choice label="Svenska" type="radio" value="two" expand></duet-choice>
          <duet-choice label="English" type="radio" value="three" expand></duet-choice>
        </duet-choice-group>
      </div>
      <duet-grid responsive>
        <duet-input label="Etunimi" placeholder="Matti" expand></duet-input>
        <duet-input label="Sukunimi" placeholder="Meikäläinen" expand></duet-input>
      </duet-grid>
      <duet-input label="Katuosoite" placeholder="Kotikatu 123" expand></duet-input>
      <duet-grid responsive>
        <duet-input label="Postinumero" placeholder="00100"></duet-input>
        <duet-input label="Kaupunki" placeholder="Helsinki" expand></duet-input>
      </duet-grid>
      <duet-grid responsive>
        <duet-input label="Postinumero" placeholder="00100" expand></duet-input>
        <duet-input label="Kaupunki" placeholder="Helsinki"></duet-input>
      </duet-grid>
      <duet-grid responsive>
        <duet-input label="Postinumero" placeholder="00100" expand></duet-input>
        <duet-grid-item min-width="calc(33.333% + 8px)"></duet-grid-item>
      </duet-grid>
    </duet-card>
  </div>
</duet-layout>

Open in new window

<duet-grid responsive breakpoint="medium" alignment="stretch" class="grid-demo">
  <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
</duet-grid>
<duet-grid responsive breakpoint="x-large" alignment="stretch" class="grid-demo">
  <duet-grid-item fill>Grid Item<br />with multiple<br />rows of text.</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
  <duet-grid-item fill>Grid Item</duet-grid-item>
</duet-grid>

Properties #

Property	Attribute	Description	Type	Default
`alignment`	`alignment`	Adjusts the vertical alignment of the grid items.	`"baseline" \| "bottom" \| "center" \| "stretch" \| "top"`	`"top"`
`breakpoint`	`breakpoint`	Switch the breakpoint used to trigger the content stacking. These match to similar media query tokens: $media-query-small and $media-query-medium.	`"medium" \| "small" \| "x-large"`	`"small"`
`direction`	`direction`	Direction of the grid items.	`"horizontal" \| "vertical"`	`"horizontal"`
`distribution`	`distribution`	Adjusts the horizontal distribution of the grid items.	`"center" \| "default" \| "left" \| "right" \| "space-around" \| "space-between" \| "space-evenly"`	`"default"`
`mobile`	`mobile`	Adjusts the horizontal alignment of the grid items on mobile (575px and under).	`"" \| "auto" \| "center" \| "left" \| "right"`	`""`
`responsive`	`responsive`	Enable or disable the automatic responsive behaviour of the grid component. Setting this option to "true" makes sure that contents are stacked vertically on mobile (575px and under).	`boolean`	`false`

Usage #

This section includes guidelines for designers and developers about the usage of this component in different contexts.

When to use #

When you need to provide structure for other components using Flexbox based layout system.
When you need to stack multiple components vertically or horizontally.

When not to use #

To build complex grids. Use CSS Grid Layout instead.

Accessibility #

This component has been validated to meet the WCAG 2.1 AA accessibility guidelines. You can find additional information regarding accessibility of this component below.

Grid is a custom element which doesn’t have semantic meaning or any added functionality for assistive technologies.

Integration

For integration, event and theming guidelines, please see Using Components. This documentation explains how to implement and use Duet’s components across different technologies like Angular, React or Vanilla JavaScript.

Integration guidelines

Tutorials

Follow these practical tutorials to learn how to build simple page layouts using Duet’s CSS Framework, Web Components and other features:

Abstract

Building Layouts

Using CLI Tools

Creating Custom Patterns

Server Side Rendering

Sharing Prototypes

Usage With Markdown

VS Code

Zeplin

Troubleshooting

If you experience any issues while using a component, please head over to the Support page for more guidelines and help.