2.5.1

Bolt Grid

Grid Component

Published

History

View changes

Install

yarn add @bolt/components-grid

Source code

View on Github

Dependencies

@bolt/core

Overview

A flexible 12-column grid with responsive breakpoint options. Part of the Bolt “Components” CSS framework that powers the Bolt Design System.

Install via NPM

npm install @bolt/components-grid

Usage

  {% include "@bolt-components-grid/grid.twig" with {
  gutter: "medium",
  row_gutter: "medium",
  items: [
    {
      column_start: "1",
      column_span: "1",
      row_start: "1",
      row_span: "1",
      valign: "start",
      content: "Item Content",
    },
  ]
} only %}

Schema

Note: when assigning component props as HTML attributes on a web component, make sure to use kebab-case.

Prop Name	Description	Type	Default Value	Option(s)
attributes	A Drupal-style attributes object with extra attributes to append to this component.	`object`	—	—
gutter	Spacing between the columns of the grid.	`string`	`medium`	`none`, `small`, `medium`, `large`
row_gutter	Spacing between the rows of the grid.	`string`	`medium`	`none`, `small`, `medium`, `large`
items	Array of grid items to render inside the grid.	`array`	—	`attributes` A Drupal-style attributes object with extra attributes to append to this component. — `content` Content to render inside each grid item. — `valign` Vertical alignment of the grid item itself. `start`, `center`, `end` `column_start` The vertical starting point of the grid item. This accepts any number from `1` to `12`, and their perspective responsive variations for advanced usage, for example, `6@small` means the column start is set at 6 for any browser width larger and equal to the small breakpoint. This prop is required to make the grid work in Internet Explorer. — `column_span` The number of columns the grid item should span across. This accepts any number from `1` to `12`, and their perspective responsive variations for advanced usage, for example, `6@small` means the column span is set at 6 for any browser width larger and equal to the small breakpoint. — `row_start` The horizontal starting point of the grid item. This prop is required to make the grid work in Internet Explorer. — `row_span` The number of rows the grid item should span across. —