Bootstrap V5.3 中文手册

Flex 弹性盒子

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

启用弹性行为

应用实用程序来创建 flexbox 容器并将直接子元素转换为 flex 项。Flex 容器和项可以使用额外的 flex 属性进一步修改。display

我是一个 flexbox 容器!
[HTML全文]
<div class="d-flex p-2">I'm a flexbox container!</div>
我是一个内联 flexbox 容器!
[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

方向

使用 direction 实用程序在 flex 容器中设置 flex 项的方向。在大多数情况下,您可以在此处省略 horizontal 类,因为浏览器默认值是 。但是,您可能会遇到需要显式设置此值的情况(例如响应式布局)。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

证明内容的合理性

使用 flexbox 容器上的实用程序更改 flex 项目在主轴上的对齐方式(要开始的 x 轴,如果是 y 轴)。从(浏览器默认)、、 或 中进行选择。justify-contentflex-direction: columnstartendcenterbetweenaroundevenly

辩护
内容
开始
辩护
内容
结束
辩护
内容
中心
辩护
内容
之间
辩护
内容
周围
辩护
内容
平等地
<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 容器上的实用程序更改 flex 项目在交叉轴上的对齐方式(要开始的 y 轴,如果是 x 轴)。从 、 或(浏览器默认)中进行选择。align-itemsflex-direction: columnstartendcenterbaselinestretch

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

对齐自身

使用 flexbox 项目上的实用程序单独更改它们在横轴上的对齐方式(开始的 y 轴,如果是 x 轴)。从与 : 、 、 或 (浏览器默认) 相同的选项中进行选择。align-selfflex-direction: columnalign-itemsstartendcenterbaselinestretch

弹性项目
对齐的柔性项目
弹性项目
弹性项目
对齐的柔性项目
弹性项目
弹性项目
对齐的柔性项目
弹性项目
弹性项目
对齐的柔性项目
弹性项目
弹性项目
对齐的柔性项目
弹性项目
<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 项目具有必要的空间。.flex-grow-*.flex-grow-1

弹性项目
弹性项目
第三个弹性项目
[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 项 with 被强制将其内容换行,“缩小”以允许更多空间用于前一个 flex 项 和 。.flex-shrink-*.flex-shrink-1.w-100

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

通过混合 、 和 或 将一个 flex 项垂直移动到容器的顶部或底部。align-itemsflex-direction: columnmargin-top: automargin-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 项在 flex 容器中的换行方式。选择使用 、 换行 、 反向换行 中进行选择。.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

次序

使用一些实用程序更改特定 flex 项目的视觉顺序。我们只提供在前或最后设置项目的选项,以及使用 DOM 顺序的重置。由于采用 0 到 5 之间的任何整数值,因此为所需的任何其他值添加自定义 CSS。orderorder

第一个弹性项目
第二个弹性项目
第三个弹性项目
[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-lastorderorder: -1order: 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

对齐内容

使用 Flexbox 容器上的实用程序将 Flex 项目在横轴上对齐在一起。从(浏览器默认)、、 或 中进行选择。为了演示这些实用程序,我们强制执行并增加了弹性项目的数量。align-contentstartendcenterbetweenaroundstretchflex-wrap: wrap

小心!此属性对单行 flex 项没有影响。

弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
弹性项目
<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 复制媒体对象组件?使用一些灵活的实用程序立即重新创建它,这些实用程序允许比以前更大的灵活性和定制性。

占 位 符图像
这是来自媒体组件的一些内容。您可以将其替换为任何内容并根据需要进行调整。
[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>

假设您要将内容垂直居中,放在图像旁边:

占 位 符图像
这是来自媒体组件的一些内容。您可以将其替换为任何内容并根据需要进行调整。
[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 中声明。了解如何使用实用程序 API。scss/_utilities.scss

"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,
  ),
),