diff --git a/site/content/docs/0.0/helpers/stacks.md b/site/content/docs/0.0/helpers/stacks.md index 834fc7390c..d80d4cbe9b 100644 --- a/site/content/docs/0.0/helpers/stacks.md +++ b/site/content/docs/0.0/helpers/stacks.md @@ -8,4 +8,87 @@ aliases: toc: true --- -{{< callout-soon "helper" >}} +Stacks offer a shortcut for applying a number of flexbox properties to quickly and easily create layouts in OUDS Web. All credit for the concept and implementation goes to the open source [Pylon project](https://almonk.github.io/pylon/). + +{{< callout warning >}} +**Heads up!** Support for gap utilities with flexbox was recently added to Safari, so consider verifying your intended browser support. Grid layout should have no issues. [Read more](https://caniuse.com/flexbox-gap). +{{< /callout >}} + +## Vertical + +Use `.vstack` to create vertical layouts. Stacked items are full-width by default. Use `.gap-*` utilities to add space between items. + +{{< example class="bd-example-flex" >}} +
+
First item
+
Second item
+
Third item
+
+{{< /example >}} + +## Horizontal + +Use `.hstack` for horizontal layouts. Stacked items are vertically centered by default and only take up their necessary width. Use `.gap-*` utilities to add space between items. + +{{< example class="bd-example-flex" >}} +
+
First item
+
Second item
+
Third item
+
+{{< /example >}} + +Using horizontal margin utilities like `.ms-auto` as spacers: + +{{< example class="bd-example-flex" >}} +
+
First item
+
Second item
+
Third item
+
+{{< /example >}} + + + + + +## CSS + +{{< scss-docs name="stacks" file="scss/helpers/_stacks.scss" >}} diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml index faa6c29e63..d7c1203e64 100644 --- a/site/data/sidebar.yml +++ b/site/data/sidebar.yml @@ -196,7 +196,6 @@ - title: Ratio draft: true - title: Stacks - draft: true - title: Stretched link draft: true - title: Text truncation