mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-03 15:24:19 +01:00
6411799e60
* Docs: Add Callout to Stacks Helper page about limited flexbox gap support Fixes: #34737 * Update stacks.md * Delete callout-warning-flexbox-gap.md Co-authored-by: XhmikosR <xhmikosr@gmail.com>
85 lines
2.7 KiB
Markdown
85 lines
2.7 KiB
Markdown
---
|
|
layout: docs
|
|
title: Stacks
|
|
description: Shorthand helpers that build on top of our flexbox utilities to make component layout faster and easier than ever.
|
|
group: helpers
|
|
toc: true
|
|
---
|
|
|
|
Stacks offer a shortcut for applying a number of flexbox properties to quickly and easily create layouts in Bootstrap. 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 >}}
|
|
<div class="vstack gap-3">
|
|
<div class="bg-light border">First item</div>
|
|
<div class="bg-light border">Second item</div>
|
|
<div class="bg-light border">Third item</div>
|
|
</div>
|
|
{{< /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 >}}
|
|
<div class="hstack gap-3">
|
|
<div class="bg-light border">First item</div>
|
|
<div class="bg-light border">Second item</div>
|
|
<div class="bg-light border">Third item</div>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
Using horizontal margin utilities like `.ms-auto` as spacers:
|
|
|
|
{{< example >}}
|
|
<div class="hstack gap-3">
|
|
<div class="bg-light border">First item</div>
|
|
<div class="bg-light border ms-auto">Second item</div>
|
|
<div class="bg-light border">Third item</div>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
And with [vertical rules]({{< docsref "/helpers/vertical-rule" >}}):
|
|
|
|
{{< example >}}
|
|
<div class="hstack gap-3">
|
|
<div class="bg-light border">First item</div>
|
|
<div class="bg-light border ms-auto">Second item</div>
|
|
<div class="vr"></div>
|
|
<div class="bg-light border">Third item</div>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
## Examples
|
|
|
|
Use `.vstack` to stack buttons and other elements:
|
|
|
|
{{< example >}}
|
|
<div class="vstack gap-2 col-md-5 mx-auto">
|
|
<button type="button" class="btn btn-secondary">Save changes</button>
|
|
<button type="button" class="btn btn-outline-secondary">Cancel</button>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
Create an inline form with `.hstack`:
|
|
|
|
{{< example >}}
|
|
<div class="hstack gap-3">
|
|
<input class="form-control me-auto" type="text" placeholder="Add your item here..." aria-label="Add your item here...">
|
|
<button type="button" class="btn btn-secondary">Submit</button>
|
|
<div class="vr"></div>
|
|
<button type="button" class="btn btn-outline-danger">Reset</button>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
## Sass
|
|
|
|
{{< scss-docs name="stacks" file="scss/helpers/_stacks.scss" >}}
|