跳到主要内容

使用完整的响应式 flexbox 工具包快速管理网格列、导航、组件等的布局、对齐和大小。对于更复杂的实现,可能需要自定义 CSS。

启用弹性行为

使用 display 工具创建一个 flexbox 容器,并将 直接子元素 转换为 flex 项。Flex 容器和项目可以通过额外的 flex 属性进一步修改。

我是一个 flexbox 容器!
HTML
<div class="d-flex p-2">I'm a flexbox container!</div>
我是一个行内弹性盒子容器!
HTML
<div class="d-inline-flex p-2">I'm an inline flexbox container!</div>

对于.d-flex和.d-inline-flex也存在响应式变体。

  • .d-flex
  • .d-inline-flex
  • .d-sm-flex
  • .d-sm-inline-flex
  • .d-md-flex
  • .d-md-inline-flex
  • .d-lg-flex
  • .d-lg-inline-flex
  • .d-xl-flex
  • .d-xl-inline-flex
  • .d-xxl-flex
  • .d-xxl-inline-flex

方向

使用方向工具类设置弹性容器中弹性项目的方向。在大多数情况下,你可以省略水平类,因为浏览器的默认值是 row。但是,你可能会遇到需要明确设置此值的情况(例如响应式布局)。

使用 .flex-row 设置水平方向(浏览器默认),或使用 .flex-row-reverse 从相反的一侧开始水平方向。

弹性项目 1
弹性项目 2
弹性项目 3
弹性项目 1
弹性项目 2
弹性项目 3
HTML
<div class="d-flex flex-row mb-3">
  <div class="p-2">Flex item 1</div>
  <div class="p-2">Flex item 2</div>
  <div class="p-2">Flex item 3</div>
</div>
<div class="d-flex flex-row-reverse">
  <div class="p-2">Flex item 1</div>
  <div class="p-2">Flex item 2</div>
  <div class="p-2">Flex item 3</div>
</div>

使用 .flex-column 设置垂直方向,或使用 .flex-column-reverse 从相反的一侧开始垂直方向。

弹性项目 1
弹性项目 2
弹性项目 3
弹性项目 1
弹性项目 2
弹性项目 3
HTML
<div class="d-flex flex-column mb-3">
  <div class="p-2">Flex item 1</div>
  <div class="p-2">Flex item 2</div>
  <div class="p-2">Flex item 3</div>
</div>
<div class="d-flex flex-column-reverse">
  <div class="p-2">Flex item 1</div>
  <div class="p-2">Flex item 2</div>
  <div class="p-2">Flex item 3</div>
</div>

flex-direction也存在响应式变体。

  • .flex-row
  • .flex-row-reverse
  • .flex-column
  • .flex-column-reverse
  • .flex-sm-row
  • .flex-sm-row-reverse
  • .flex-sm-column
  • .flex-sm-column-reverse
  • .flex-md-row
  • .flex-md-row-reverse
  • .flex-md-column
  • .flex-md-column-reverse
  • .flex-lg-row
  • .flex-lg-row-reverse
  • .flex-lg-column
  • .flex-lg-column-reverse
  • .flex-xl-row
  • .flex-xl-row-reverse
  • .flex-xl-column
  • .flex-xl-column-reverse
  • .flex-xxl-row
  • .flex-xxl-row-reverse
  • .flex-xxl-column
  • .flex-xxl-column-reverse

对齐内容

在弹性盒子容器上使用 justify-content 工具类来改变主轴上弹性子项的对齐方式(x 轴为起点,如果是 flex-direction: column 则为 y 轴)。从 start(浏览器默认)、end、center、between、around 或 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>

justify-content也存在响应式变体。

  • .justify-content-start
  • .justify-content-end
  • .justify-content-center
  • .justify-content-between
  • .justify-content-around
  • .justify-content-evenly
  • .justify-content-sm-start
  • .justify-content-sm-end
  • .justify-content-sm-center
  • .justify-content-sm-between
  • .justify-content-sm-around
  • .justify-content-sm-evenly
  • .justify-content-md-start
  • .justify-content-md-end
  • .justify-content-md-center
  • .justify-content-md-between
  • .justify-content-md-around
  • .justify-content-md-evenly
  • .justify-content-lg-start
  • .justify-content-lg-end
  • .justify-content-lg-center
  • .justify-content-lg-between
  • .justify-content-lg-around
  • .justify-content-lg-evenly
  • .justify-content-xl-start
  • .justify-content-xl-end
  • .justify-content-xl-center
  • .justify-content-xl-between
  • .justify-content-xl-around
  • .justify-content-xl-evenly
  • .justify-content-xxl-start
  • .justify-content-xxl-end
  • .justify-content-xxl-center
  • .justify-content-xxl-between
  • .justify-content-xxl-around
  • .justify-content-xxl-evenly

对齐项目

在 flexbox 容器上使用 align-items 工具类来改变 flex 项在交叉轴(y 轴为默认,x 轴如果 flex-direction: column)上的对齐方式。可从 start、end、center、baseline 或 stretch(浏览器默认)中选择。

弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
弹性子项
<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>

align-items也存在响应式变体。

  • .align-items-start
  • .align-items-end
  • .align-items-center
  • .align-items-baseline
  • .align-items-stretch
  • .align-items-sm-start
  • .align-items-sm-end
  • .align-items-sm-center
  • .align-items-sm-baseline
  • .align-items-sm-stretch
  • .align-items-md-start
  • .align-items-md-end
  • .align-items-md-center
  • .align-items-md-baseline
  • .align-items-md-stretch
  • .align-items-lg-start
  • .align-items-lg-end
  • .align-items-lg-center
  • .align-items-lg-baseline
  • .align-items-lg-stretch
  • .align-items-xl-start
  • .align-items-xl-end
  • .align-items-xl-center
  • .align-items-xl-baseline
  • .align-items-xl-stretch
  • .align-items-xxl-start
  • .align-items-xxl-end
  • .align-items-xxl-center
  • .align-items-xxl-baseline
  • .align-items-xxl-stretch

对齐自身

在弹性盒子项目上使用 align-self 工具类来单独更改它们在交叉轴上的对齐方式(默认是 y 轴,如果使用 flex-direction: column 则为 x 轴)。可从与 align-items 相同的选项中选择:start、end、center、baseline 或 stretch(浏览器默认)。

弹性项
对齐的弹性项目
弹性项
弹性项
对齐的弹性项目
弹性项
弹性项
对齐的弹性项目
弹性项
弹性项
对齐的弹性项目
弹性项
弹性项
对齐的弹性项目
弹性项
<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>

align-self也存在响应式变体。

  • .align-self-start
  • .align-self-end
  • .align-self-center
  • .align-self-baseline
  • .align-self-stretch
  • .align-self-sm-start
  • .align-self-sm-end
  • .align-self-sm-center
  • .align-self-sm-baseline
  • .align-self-sm-stretch
  • .align-self-md-start
  • .align-self-md-end
  • .align-self-md-center
  • .align-self-md-baseline
  • .align-self-md-stretch
  • .align-self-lg-start
  • .align-self-lg-end
  • .align-self-lg-center
  • .align-self-lg-baseline
  • .align-self-lg-stretch
  • .align-self-xl-start
  • .align-self-xl-end
  • .align-self-xl-center
  • .align-self-xl-baseline
  • .align-self-xl-stretch
  • .align-self-xxl-start
  • .align-self-xxl-end
  • .align-self-xxl-center
  • .align-self-xxl-baseline
  • .align-self-xxl-stretch

填充

在一系列兄弟元素上使用 .flex-fill 类,可以强制它们的宽度等于其内容(或者如果内容没有超出其边框,则宽度相等),同时占用所有可用的水平空间。

内容很多的弹性子项
弹性项
弹性项
HTML
<div class="d-flex">
  <div class="p-2 flex-fill">Flex item with a lot of content</div>
  <div class="p-2 flex-fill">Flex item</div>
  <div class="p-2 flex-fill">Flex item</div>
</div>

flex-fill也存在响应式变体。

  • .flex-fill
  • .flex-sm-fill
  • .flex-md-fill
  • .flex-lg-fill
  • .flex-xl-fill
  • .flex-xxl-fill

增长与收缩

使用 .flex-grow-* 工具类切换 flex 项目填充可用空间的能力。在下面的示例中,.flex-grow-1 元素使用了所有它可以使用的空间,同时允许其余两个 flex 项目拥有它们所需的空间。

弹性项
弹性项
第三个弹性项目
HTML
<div class="d-flex">
  <div class="p-2 flex-grow-1">Flex item</div>
  <div class="p-2">Flex item</div>
  <div class="p-2">Third flex item</div>
</div>

使用 .flex-shrink-* 工具类在必要时切换 flex 项的收缩能力。在下面的示例中,带有 .flex-shrink-1 的第二个 flex 项被迫将其内容换行,“收缩”以为带有 .w-100 的前一个 flex 项腾出更多空间。

弹性项
弹性项
HTML
<div class="d-flex">
  <div class="p-2 w-100">Flex item</div>
  <div class="p-2 flex-shrink-1">Flex item</div>
</div>

对于flex-grow和flex-shrink也存在响应式变体。

  • .flex-{grow|shrink}-0
  • .flex-{grow|shrink}-1
  • .flex-sm-{grow|shrink}-0
  • .flex-sm-{grow|shrink}-1
  • .flex-md-{grow|shrink}-0
  • .flex-md-{grow|shrink}-1
  • .flex-lg-{grow|shrink}-0
  • .flex-lg-{grow|shrink}-1
  • .flex-xl-{grow|shrink}-0
  • .flex-xl-{grow|shrink}-1
  • .flex-xxl-{grow|shrink}-0
  • .flex-xxl-{grow|shrink}-1

自动边距

当将 flex 对齐与自动边距结合使用时,Flexbox 可以完成一些非常棒的事情。下面展示了通过自动边距控制 flex 项目的三个示例:默认(没有自动边距)、将两个项目推到右边(.me-auto)、以及将两个项目推到左边(.ms-auto)。

弹性项
弹性项
弹性项
弹性项
弹性项
弹性项
弹性项
弹性子项
弹性项
HTML
<div class="d-flex mb-3">
  <div class="p-2">Flex item</div>
  <div class="p-2">Flex item</div>
  <div class="p-2">Flex item</div>
</div>

<div class="d-flex mb-3"> <div class="me-auto p-2">Flex item</div> <div class="p-2">Flex item</div> <div class="p-2">Flex item</div> </div>

<div class="d-flex mb-3"> <div class="p-2">Flex item</div> <div class="p-2">Flex item</div> <div class="ms-auto p-2">Flex item</div> </div>

使用 align-items

通过混合align-items、flex-direction: column和margin-top: auto或margin-bottom: auto,将一个弹性项目在容器中垂直移动到顶部或底部。

弹性项
弹性项
弹性子项
弹性项
弹性项
弹性项
HTML
<div class="d-flex align-items-start flex-column mb-3" style="height: 200px;">
  <div class="mb-auto p-2">Flex item</div>
  <div class="p-2">Flex item</div>
  <div class="p-2">Flex item</div>
</div>

<div class="d-flex align-items-end flex-column mb-3" style="height: 200px;"> <div class="p-2">Flex item</div> <div class="p-2">Flex item</div> <div class="mt-auto p-2">Flex item</div> </div>

包裹

更改弹性容器中弹性项目的换行方式。可以选择完全不换行(浏览器默认)使用 .flex-nowrap,换行使用 .flex-wrap,或反向换行使用 .flex-wrap-reverse。

弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
<div class="d-flex flex-nowrap">
  ...
</div>
弹性项目 1
弹性项目 2
弹性项目 3
弹性项目 4
弹性项目 5
弹性项目 6
弹性项目 7
弹性项目 8
弹性项目 9
弹性项目 10
弹性项目 11
弹性项目 12
弹性项目 13
弹性项目 14
<div class="d-flex flex-wrap">
  ...
</div>
弹性项目 1
弹性项目 2
弹性项目 3
弹性项目 4
弹性项目 5
弹性项目 6
弹性项目 7
弹性项目 8
弹性项目 9
弹性项目 10
弹性项目 11
弹性项目 12
弹性项目 13
弹性项目 14
<div class="d-flex flex-wrap-reverse">
  ...
</div>

flex-wrap也存在响应式变体。

  • .flex-nowrap
  • .flex-wrap
  • .flex-wrap-reverse
  • .flex-sm-nowrap
  • .flex-sm-wrap
  • .flex-sm-wrap-reverse
  • .flex-md-nowrap
  • .flex-md-wrap
  • .flex-md-wrap-reverse
  • .flex-lg-nowrap
  • .flex-lg-wrap
  • .flex-lg-wrap-reverse
  • .flex-xl-nowrap
  • .flex-xl-wrap
  • .flex-xl-wrap-reverse
  • .flex-xxl-nowrap
  • .flex-xxl-wrap
  • .flex-xxl-wrap-reverse

订单

改变 视觉的 具有少量特定弹性项目的顺序 order 工具类。我们仅提供将项目置于首位或末位的选项,以及重置以使用 DOM 顺序。由于 order 取任意从 0 到 5 的整数值,如需其他值,可添加自定义 CSS。

第一个弹性项目
第二个弹性项目
第三个弹性项目
HTML
<div class="d-flex flex-nowrap">
  <div class="order-3 p-2">First flex item</div>
  <div class="order-2 p-2">Second flex item</div>
  <div class="order-1 p-2">Third flex item</div>
</div>

order也存在响应式变体。

  • .order-0
  • .order-1
  • .order-2
  • .order-3
  • .order-4
  • .order-5
  • .order-sm-0
  • .order-sm-1
  • .order-sm-2
  • .order-sm-3
  • .order-sm-4
  • .order-sm-5
  • .order-md-0
  • .order-md-1
  • .order-md-2
  • .order-md-3
  • .order-md-4
  • .order-md-5
  • .order-lg-0
  • .order-lg-1
  • .order-lg-2
  • .order-lg-3
  • .order-lg-4
  • .order-lg-5
  • .order-xl-0
  • .order-xl-1
  • .order-xl-2
  • .order-xl-3
  • .order-xl-4
  • .order-xl-5
  • .order-xxl-0
  • .order-xxl-1
  • .order-xxl-2
  • .order-xxl-3
  • .order-xxl-4
  • .order-xxl-5

此外,还有响应式的 .order-first 和 .order-last 改变……的类 order 通过应用一个元素的 order: -1 和 order: 6分别。

  • .order-first
  • .order-last
  • .order-sm-first
  • .order-sm-last
  • .order-md-first
  • .order-md-last
  • .order-lg-first
  • .order-lg-last
  • .order-xl-first
  • .order-xl-last
  • .order-xxl-first
  • .order-xxl-last

对齐内容

在弹性盒子容器上使用 align-content 工具类来在交叉轴上 一起 对齐弹性项目。可选择 start(浏览器默认)、end、center、between、around 或 stretch。为了演示这些工具,我们已应用 flex-wrap: wrap 并增加了弹性项目的数量。

注意! 这个属性对单行弹性项目没有效果。

弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
<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>

align-content也存在响应式变体。

  • .align-content-start
  • .align-content-end
  • .align-content-center
  • .align-content-between
  • .align-content-around
  • .align-content-stretch
  • .align-content-sm-start
  • .align-content-sm-end
  • .align-content-sm-center
  • .align-content-sm-between
  • .align-content-sm-around
  • .align-content-sm-stretch
  • .align-content-md-start
  • .align-content-md-end
  • .align-content-md-center
  • .align-content-md-between
  • .align-content-md-around
  • .align-content-md-stretch
  • .align-content-lg-start
  • .align-content-lg-end
  • .align-content-lg-center
  • .align-content-lg-between
  • .align-content-lg-around
  • .align-content-lg-stretch
  • .align-content-xl-start
  • .align-content-xl-end
  • .align-content-xl-center
  • .align-content-xl-between
  • .align-content-xl-around
  • .align-content-xl-stretch
  • .align-content-xxl-start
  • .align-content-xxl-end
  • .align-content-xxl-center
  • .align-content-xxl-between
  • .align-content-xxl-around
  • .align-content-xxl-stretch

媒体对象

想要复制 Bootstrap 4 的媒体对象组件吗?通过一些弹性工具可以在短时间内重新创建它,这些工具比以前提供了更多的灵活性和自定义功能。

PlaceholderImage
这是来自媒体组件的一些内容。你可以用任何内容替换它,并根据需要进行调整。
HTML
<div class="d-flex">
  <div class="flex-shrink-0">
    <img src="..." alt="...">
  </div>
  <div class="flex-grow-1 ms-3">
    This is some content from a media component. You can replace this with any content and adjust it as needed.
  </div>
</div>

假设你想要将图像旁边的内容垂直居中:

PlaceholderImage
这是来自媒体组件的一些内容。你可以用任何内容替换它,并根据需要进行调整。
HTML
<div class="d-flex align-items-center">
  <div class="flex-shrink-0">
    <img src="..." alt="...">
  </div>
  <div class="flex-grow-1 ms-3">
    This is some content from a media component. You can replace this with any content and adjust it as needed.
  </div>
</div>

CSS

Sass 工具 API

Flexbox 工具在我们的工具 API 中的 scss/_utilities.scss 声明。了解如何使用工具 API。

"flex": (
  responsive: true,
  property: flex,
  values: (fill: 1 1 auto)
),
"flex-direction": (
  responsive: true,
  property: flex-direction,
  class: flex,
  values: row column row-reverse column-reverse
),
"flex-grow": (
  responsive: true,
  property: flex-grow,
  class: flex,
  values: (
    grow-0: 0,
    grow-1: 1,
  )
),
"flex-shrink": (
  responsive: true,
  property: flex-shrink,
  class: flex,
  values: (
    shrink-0: 0,
    shrink-1: 1,
  )
),
"flex-wrap": (
  responsive: true,
  property: flex-wrap,
  class: flex,
  values: wrap nowrap wrap-reverse
),
"justify-content": (
  responsive: true,
  property: justify-content,
  values: (
    start: flex-start,
    end: flex-end,
    center: center,
    between: space-between,
    around: space-around,
    evenly: space-evenly,
  )
),
"align-items": (
  responsive: true,
  property: align-items,
  values: (
    start: flex-start,
    end: flex-end,
    center: center,
    baseline: baseline,
    stretch: stretch,
  )
),
"align-content": (
  responsive: true,
  property: align-content,
  values: (
    start: flex-start,
    end: flex-end,
    center: center,
    between: space-between,
    around: space-around,
    stretch: stretch,
  )
),
"align-self": (
  responsive: true,
  property: align-self,
  values: (
    auto: auto,
    start: flex-start,
    end: flex-end,
    center: center,
    baseline: baseline,
    stretch: stretch,
  )
),
"order": (
  responsive: true,
  property: order,
  values: (
    first: -1,
    0: 0,
    1: 1,
    2: 2,
    3: 3,
    4: 4,
    5: 5,
    last: 6,
  ),
),