diff --git a/scss/_helpers.scss b/scss/_helpers.scss index 8f566d12f..121ecc064 100644 --- a/scss/_helpers.scss +++ b/scss/_helpers.scss @@ -2,6 +2,7 @@ @import "helpers/colored-links"; @import "helpers/ratio"; @import "helpers/position"; +@import "helpers/quick-grid"; @import "helpers/visually-hidden"; @import "helpers/stretched-link"; @import "helpers/text-truncation"; diff --git a/scss/helpers/_quick-grid.scss b/scss/helpers/_quick-grid.scss new file mode 100644 index 000000000..7dfa33a66 --- /dev/null +++ b/scss/helpers/_quick-grid.scss @@ -0,0 +1,7 @@ +// scss-docs-start quick-grid +.quick-grid { + --columns: 1; + display: grid; + grid-template-columns: repeat(var(--columns), 1fr); +} +// scss-docs-end quick-grid diff --git a/site/content/docs/5.0/helpers/quick-grid.md b/site/content/docs/5.0/helpers/quick-grid.md new file mode 100644 index 000000000..8af4b1550 --- /dev/null +++ b/site/content/docs/5.0/helpers/quick-grid.md @@ -0,0 +1,73 @@ +--- +layout: docs +title: Quick grid +description: Helpers that build on top of our CSS Grid utilities to make component layout faster and easier than ever. +group: helpers +toc: true +--- + +## How it works + +The quick grid helper utilizes CSS Grid layout and some local CSS custom properties to quickly and efficiently configure the layout of set of elements. + +{{< scss-docs name="quick-grid" file="scss/helpers/_quick-grid.scss" >}} + +We set the `display` to engage the CSS Grid, specify a default `--columns` count of `1` for easy vertical stacking, and provide a column template that uses the `--columns` to equally layout any number of columns. + +When paired with `.gap-*` utilities, you can easily adjust the `gap` between elements. + +## Examples + +### Vertical + +Create a single column of stacked items. + +{{< example >}} +