Enable flex behaviors#
Apply display utilities to create a flexbox container and transform direct
children elements into flex items. Flex containers and items are able to be
modified further with additional flex properties.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Responsive variations also exist for .d-flex and .d-inline-flex.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.d{ { .abbr } }-flex.d{ { .abbr } }-inline-flex{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Direction#
Set the direction of flex items in a flex container with direction utilities. In
most cases you can omit the horizontal class here as the browser default is
row. However, you may encounter situations where you needed to explicitly set
this value (like responsive layouts).
Use .flex-row to set a horizontal direction (the browser default), or
.flex-row-reverse to start the horizontal direction from the opposite side.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Use .flex-column to set a vertical direction, or .flex-column-reverse to
start the vertical direction from the opposite side.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Responsive variations also exist for flex-direction.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.flex{ { .abbr } }-row.flex{ { .abbr } }-row-reverse.flex{ { .abbr } }-column.flex{ { .abbr } }-column-reverse{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Justify content#
Use justify-content utilities on flexbox containers to change the alignment of
flex items on the main axis (the x-axis to start, y-axis if
flex-direction: column). Choose from start (browser default), end,
center, between, around, or evenly.
<div class="d-flex justify-content-start">...</div>
<div class="d-flex justify-content-end">...</div>
<div class="d-flex justify-content-center">...</div>
<div class="d-flex justify-content-between">...</div>
<div class="d-flex justify-content-around">...</div>
<div class="d-flex justify-content-evenly">...</div>
Responsive variations also exist for justify-content.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.justify-content{ { .abbr } }-start.justify-content{ { .abbr } }-end.justify-content{ { .abbr } }-center.justify-content{ { .abbr } }-between.justify-content{ { .abbr } }-around.justify-content{ { .abbr } }-evenly{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Align items#
Use align-items utilities on flexbox containers to change the alignment of
flex items on the cross axis (the y-axis to start, x-axis if
flex-direction: column). Choose from start, end, center, baseline, or
stretch (browser default).
<div class="d-flex align-items-start">...</div>
<div class="d-flex align-items-end">...</div>
<div class="d-flex align-items-center">...</div>
<div class="d-flex align-items-baseline">...</div>
<div class="d-flex align-items-stretch">...</div>
Responsive variations also exist for align-items.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.align-items{ { .abbr } }-start.align-items{ { .abbr } }-end.align-items{ { .abbr } }-center.align-items{ { .abbr } }-baseline.align-items{ { .abbr } }-stretch{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Align self#
Use align-self utilities on flexbox items to individually change their
alignment on the cross axis (the y-axis to start, x-axis if
flex-direction: column). Choose from the same options as align-items:
start, end, center, baseline, or stretch (browser default).
<div class="align-self-start">Aligned flex item</div>
<div class="align-self-end">Aligned flex item</div>
<div class="align-self-center">Aligned flex item</div>
<div class="align-self-baseline">Aligned flex item</div>
<div class="align-self-stretch">Aligned flex item</div>
Responsive variations also exist for align-self.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.align-self{ { .abbr } }-start.align-self{ { .abbr } }-end.align-self{ { .abbr } }-center.align-self{ { .abbr } }-baseline.align-self{ { .abbr } }-stretch{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Fill#
Use the .flex-fill class on a series of sibling elements to force them into
widths equal to their content (or equal widths if their content does not surpass
their border-boxes) while taking up all available horizontal space.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Responsive variations also exist for flex-fill.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.flex{ { .abbr } }-fill{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Grow and shrink#
Use .flex-grow-* utilities to toggle a flex item's ability to grow to fill
available space. In the example below, the .flex-grow-1 elements uses all
available space it can, while allowing the remaining two flex items their
necessary space.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Use .flex-shrink-* utilities to toggle a flex item's ability to shrink if
necessary. In the example below, the second flex item with .flex-shrink-1 is
forced to wrap its contents to a new line, "shrinking" to allow more space for
the previous flex item with .w-100.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Responsive variations also exist for flex-grow and flex-shrink.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.flex{ { .abbr } }-{grow|shrink}-0.flex{ { .abbr } }-{grow|shrink}-1{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Auto margins#
Flexbox can do some pretty awesome things when you mix flex alignments with auto
margins. Shown below are three examples of controlling flex items via auto
margins: default (no auto margin), pushing two items to the right (.me-auto),
and pushing two items to the left (.ms-auto).
{ { < example class="bd-example-flex" }}
{ {< /example >} }
With align-items#
Vertically move one flex item to the top or bottom of a container by mixing
align-items, flex-direction: column, and margin-top: auto or
margin-bottom: auto.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Wrap#
Change how flex items wrap in a flex container. Choose from no wrapping at all (
the browser default) with .flex-nowrap, wrapping with .flex-wrap, or reverse
wrapping with .flex-wrap-reverse.
<div class="d-flex flex-nowrap">
...
</div>
<div class="d-flex flex-wrap">
...
</div>
<div class="d-flex flex-wrap-reverse">
...
</div>
Responsive variations also exist for flex-wrap.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.flex{ { .abbr } }-nowrap.flex{ { .abbr } }-wrap.flex{ { .abbr } }-wrap-reverse{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Order#
Change the visual order of specific flex items with a handful of order
utilities. We only provide options for making an item first or last, as well as
a reset to use the DOM order. As order takes any integer value from 0 to 5,
add custom CSS for any additional values needed.
{ { < example class="bd-example-flex" }}
{ {< /example >} }
Responsive variations also exist for order.
{ { < markdown }} { {< flex.inline >} } { {- range $bp := $.Site.Data.breakpoints -} } { {- range (seq 0 5) } }
.order{ { $bp.abbr } }-{ { . } }{ {- end -} } { {- end -} } { {< /flex.inline >} } { { < /markdown }}
Additionally there are also responsive .order-first and .order-last classes
that change the order of an element by applying order: -1 and order: 6,
respectively.
{ { < markdown }} { {< flex.inline >} } { {- range $bp := $.Site.Data.breakpoints -} } { {- range (slice "first" "last") } }
.order{ { $bp.abbr } }-{ { . } }{ {- end -} } { {- end -} } { {< /flex.inline >} } { { < /markdown }}
Align content#
Use align-content utilities on flexbox containers to align flex items
together on the cross axis. Choose from start (browser default), end,
center, between, around, or stretch. To demonstrate these utilities,
we've enforced flex-wrap: wrap and increased the number of flex items.
Heads up! This property has no effect on single rows of flex items.
<div class="d-flex align-content-start flex-wrap">
...
</div>
<div class="d-flex align-content-end flex-wrap">...</div>
<div class="d-flex align-content-center flex-wrap">...</div>
<div class="d-flex align-content-between flex-wrap">...</div>
<div class="d-flex align-content-around flex-wrap">...</div>
<div class="d-flex align-content-stretch flex-wrap">...</div>
Responsive variations also exist for align-content.
{ { < markdown }} { {< flex.inline >} } { {- range $.Site.Data.breakpoints } }
.align-content{ { .abbr } }-start.align-content{ { .abbr } }-end.align-content{ { .abbr } }-center.align-content{ { .abbr } }-between.align-content{ { .abbr } }-around.align-content{ { .abbr } }-stretch{ {- end -} } { {< /flex.inline >} } { { < /markdown }}
Media object#
Looking to replicate the media object component from Bootstrap 4? Recreate it in no time with a few flex utilities that allow even more flexibility and customization than before.
{ {< example >} }
{ {< /example >} }
And say you want to vertically center the content next to the image:
{ {< example >} }
{ {< /example >} }
CSS#
Sass utilities API#
Flexbox utilities are declared in our utilities API in
scss/_utilities.scss. Learn how to use the utilities API.
{ { < scss-docs name="utils-flex" file="scss/_utilities.scss" }}