0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-01 13:24:25 +01:00
Bootstrap/docs/utilities/flexbox.md
2016-12-24 14:21:04 -08:00

16 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.

{% 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 %}

  • .d{{ bp.abbr }}-flex
  • .d{{ bp.abbr }}-inline-flex{% endfor %}

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 %}

  • .flex{{ bp.abbr }}-row
  • .flex{{ bp.abbr }}-column{% endfor %}

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 %}

  • .flex{{ bp.abbr }}-nowrap
  • .flex{{ bp.abbr }}-wrap{% endfor %}

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, or around.

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

{% highlight html %}

...
...
...
...
...
{% endhighlight %}

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).

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

{% highlight html %}

...
...
...
...
...
{% endhighlight %}

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).

Flex item
Aligned flex item
Flex item
Flex item
Aligned flex item
Flex item
Flex item
Aligned flex item
Flex item
Flex item
Aligned flex item
Flex item
Flex item
Aligned flex item
Flex item

{% highlight html %}

Aligned flex item
Aligned flex item
Aligned flex item
Aligned flex item
Aligned flex item
{% endhighlight %}

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 (e.g., 5), add custom CSS for any additional values needed.

{% example html %}

First flex item
Second flex item
Third flex item
{% endexample %}

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 affect on single rows of flex items.

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
{% highlight html %}
...
{% endhighlight %}
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
{% highlight html %}
...
{% endhighlight %}
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
{% highlight html %}
...
{% endhighlight %}
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
{% highlight html %}
...
{% endhighlight %}
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
{% highlight html %}
...
{% endhighlight %}
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
{% highlight html %}
...
{% endhighlight %}