0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-01 13:24:25 +01:00
Bootstrap/docs/utilities/flexbox.md
Mark Otto 5464f4ab7e Start to blow out and document more flexbox utilities
- Adds new flexbox.md file to utilities docs

- Adds a `breakpoints.yml` data file for easier output of responsive classes in the docs. Will put this to use on other pages soon.

- Adds hella flex utils. There are some dupes for now, but they'll get removed in time.
2016-12-24 14:21:04 -08:00

5.9 KiB

layout title group
docs Flexbox utilities

Quickly manage the layout, alignment, and sizing of grid columns, navigation, components, and more with a full suite of responsive flexbox utilities. For more complex implementations, custom CSS may be necessary.

Contents

  • Will be replaced with the ToC, excluding the "Contents" header {:toc}

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. Choose from the following options.

Class property: value; Description
.d-flex display: flex; Creates a block-level element using the flexbox model.
.d-inline-flex display: inline-flex; Creates an inline-level element using the flexbox model.

{% example html %}

I'm a flexbox container!
{% endexample %}

{% example html %}

I'm an inline flexbox container!
{% endexample %}

Responsive variations also exist for .d-flex and .d-inline-flex.

{% for bp in site.data.breakpoints %} {% endfor %} {% for bp in site.data.breakpoints %} {% endfor %}
Class Description
.d{{ bp.abbr }}-flex Sets display: flex; on viewports {{ bp.min-width }} wide and up
.d{{ bp.abbr }}-inline-flex Sets display: inline-flex; on viewports {{ bp.min-width }} wide and up

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.

{% example html %}

Flex item
Flex item
Flex item
{% endexample %}

Use .flex-column to set a vertical direction.

{% example html %}

Flex item
Flex item
Flex item
{% endexample %}

Responsive variations also exist for .flex-row and .flex-column.

{% for bp in site.data.breakpoints %} {% endfor %} {% for bp in site.data.breakpoints %} {% endfor %}
Class Description
.flex{{ bp.abbr }}-row Sets flex-direction: row; on viewports {{ bp.min-width }} wide and up
.flex{{ bp.abbr }}-column Sets flex-direction: column; on viewports {{ bp.min-width }} wide and up

Wrap

Change how flex items wrap in a flex container. Choose from no wrapping at all (the browser default) with .flex-nowrap, or enable wrapping with .flex-wrap.

{% example html %}

Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
{% endexample %}

{% example html %}

Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
Flex item
{% endexample %}

Responsive variations also exist for .flex-nowrap and .flex-wrap.

{% for bp in site.data.breakpoints %} {% endfor %} {% for bp in site.data.breakpoints %} {% endfor %}
Class Description
.flex{{ bp.abbr }}-nowrap Sets flex-wrap: nowrap; on viewports {{ bp.min-width }} wide and up
.flex{{ bp.abbr }}-wrap Sets flex-wrap: wrap; on viewports {{ bp.min-width }} wide and up