View on GitHub

间距（Spacing）

Bootstrap 包含一系列速记的响应式 margin、padding 和 gap 实用工具类，用于修改元素的外观。

On this page

Margin and padding

使用速记类为元素或其边框的子集分配响应友好的 margin 或padding 值。包括对单个属性、所有属性以及垂直和水平属性的支持。类是根据从 .25rem 到 3rem 的默认 Sass 映射构建的。

使用 CSS 网格布局模块？ 考虑使用 gap 实用工具代替。

Notation

适用于所有断点的间距实用程序（从 xs 到 xxl）中没有断点缩写。这是因为这些类别是从 min-width: 0 起应用的，因此不受媒体查询的约束。不过，其余断点都包含断点缩写。

类的命名格式为：xs为{property}{sides}-{size}，sm、md、lg、xl和 xxl为{property}{sides}-{breakpoint}-{size}。

其中 property 是以下内容之一：

m - 用于设置 margin 的类
p - 用于设置了 padding 的类

其中 sides 是其中之一：

t - 用于设置了 margin-top 或 padding-top 的类
b - 用于设置了 margin-bottom 或 padding-bottom 的类
s - （开始）用于在 LTR 中设置 margin-left 或 padding-left 的类，在 RTL 中设置 margin-right 或 padding-right 的类
e - （结束），用于在 LTR 中设置了 margin-right 或 padding-right, 在 RTL 中设置了 margin-left 或 padding-left 的类
x - 用于同时设置了 *-left 和 *-right 的类
y - 用于同时设置了 *-top 和 *-bottom 的类
空白 - 用于在元素的四边都设置了 margin 或 padding 的类

其中 size 是其中之一：

0 - 适用于将 margin 或 padding 设置为 0 以消除 margin 或 padding 的类
1 - （默认情况下）用于将 margin 或 padding 设置为 $spacer * .25 的类
2 - （默认情况下）用于将 margin 或 padding 设置为 $spacer * .5 的类
3 - （默认情况下）用于将 margin 或 padding 设置为 $spacer 的类
4 - （默认情况下）用于将 margin 或 padding 设置为 $spacer * 1.5 的类
5 - （默认情况下）用于将 margin 或 padding 设置为 $spacer * 3 的类
auto - 用于将 margin 设置为自动的类

(您可以通过在 $spacers Sass 映射变量中添加条目来增加更多尺寸)。

示例

下面是这些类的一些代表性例子：

.mt-0 {
  margin-top: 0 !important;
}

.ms-1 {
  margin-left: ($spacer * .25) !important;
}

.px-2 {
  padding-left: ($spacer * .5) !important;
  padding-right: ($spacer * .5) !important;
}

.p-3 {
  padding: $spacer !important;
}

水平居中

此外，Bootstrap 还包含一个 .mx-auto 类，通过将水平边距设置为 auto，将固定宽度的块级内容（即设置了 display: block 和 width 的内容）水平居中。

Centered element

<div class="mx-auto p-2" style="width: 200px;">
  Centered element
</div>

负边距

在 CSS 中，margin 属性可以使用负值（padding不能）。这些负边距 默认是禁用的 ，但在 Sass 中可以通过设置 $enable-negative-margins: true 来启用。

语法与默认的正边距实用工具几乎相同，只是在要求的大小前增加了n。下面是一个与 .mt-1 相反的示例类：

.mt-n1 {
  margin-top: -0.25rem !important;
}

间隙

使用 display: grid 或 display: flex 时，可以在父元素上使用 gap 工具。这样就不必为网格或 flex 容器的单个子元素添加边距实用程序。间隙实用程序默认为响应式，通过我们的实用程序 API 生成，基于 $spacers Sass 映射。

Grid item 1

Grid item 2

Grid item 3

Grid item 4

html

<div class="grid gap-3">
  <div class="p-2 g-col-6">Grid item 1</div>
  <div class="p-2 g-col-6">Grid item 2</div>
  <div class="p-2 g-col-6">Grid item 3</div>
  <div class="p-2 g-col-6">Grid item 4</div>
</div>

支持包括所有 Bootstrap 网格断点的响应选项，以及 $spacers 地图（0-5）中的六种尺寸。没有 .gap-auto 实用工具类，因为它实际上与 .gap-0相同。

行间隙

row-gap 设置指定容器中子项之间的垂直空间。

Grid item 1

Grid item 2

Grid item 3

Grid item 4

html

<div class="grid gap-0 row-gap-3">
  <div class="p-2 g-col-6">Grid item 1</div>
  <div class="p-2 g-col-6">Grid item 2</div>
  <div class="p-2 g-col-6">Grid item 3</div>
  <div class="p-2 g-col-6">Grid item 4</div>
</div>

列间隙

column-gap 设置指定容器中子项之间的水平空间。

Grid item 1

Grid item 2

Grid item 3

Grid item 4

html

<div class="grid gap-0 column-gap-3">
  <div class="p-2 g-col-6">Grid item 1</div>
  <div class="p-2 g-col-6">Grid item 2</div>
  <div class="p-2 g-col-6">Grid item 3</div>
  <div class="p-2 g-col-6">Grid item 4</div>
</div>

CSS

Sass 映射

间距实用程序通过 Sass map 声明，然后使用我们的实用程序 API 生成。

scss/_variables.scss

$spacer: 1rem;
$spacers: (
  0: 0,
  1: $spacer * .25,
  2: $spacer * .5,
  3: $spacer,
  4: $spacer * 1.5,
  5: $spacer * 3,
);

Sass utilities API

间距实用程序已在 scss/_utilities.scss 中的实用程序 API 中声明。了解如何使用实用程序 API

scss/_utilities.scss

"margin": (
  responsive: true,
  property: margin,
  class: m,
  values: map-merge($spacers, (auto: auto))
),
"margin-x": (
  responsive: true,
  property: margin-right margin-left,
  class: mx,
  values: map-merge($spacers, (auto: auto))
),
"margin-y": (
  responsive: true,
  property: margin-top margin-bottom,
  class: my,
  values: map-merge($spacers, (auto: auto))
),
"margin-top": (
  responsive: true,
  property: margin-top,
  class: mt,
  values: map-merge($spacers, (auto: auto))
),
"margin-end": (
  responsive: true,
  property: margin-right,
  class: me,
  values: map-merge($spacers, (auto: auto))
),
"margin-bottom": (
  responsive: true,
  property: margin-bottom,
  class: mb,
  values: map-merge($spacers, (auto: auto))
),
"margin-start": (
  responsive: true,
  property: margin-left,
  class: ms,
  values: map-merge($spacers, (auto: auto))
),
// Negative margin utilities
"negative-margin": (
  responsive: true,
  property: margin,
  class: m,
  values: $negative-spacers
),
"negative-margin-x": (
  responsive: true,
  property: margin-right margin-left,
  class: mx,
  values: $negative-spacers
),
"negative-margin-y": (
  responsive: true,
  property: margin-top margin-bottom,
  class: my,
  values: $negative-spacers
),
"negative-margin-top": (
  responsive: true,
  property: margin-top,
  class: mt,
  values: $negative-spacers
),
"negative-margin-end": (
  responsive: true,
  property: margin-right,
  class: me,
  values: $negative-spacers
),
"negative-margin-bottom": (
  responsive: true,
  property: margin-bottom,
  class: mb,
  values: $negative-spacers
),
"negative-margin-start": (
  responsive: true,
  property: margin-left,
  class: ms,
  values: $negative-spacers
),
// Padding utilities
"padding": (
  responsive: true,
  property: padding,
  class: p,
  values: $spacers
),
"padding-x": (
  responsive: true,
  property: padding-right padding-left,
  class: px,
  values: $spacers
),
"padding-y": (
  responsive: true,
  property: padding-top padding-bottom,
  class: py,
  values: $spacers
),
"padding-top": (
  responsive: true,
  property: padding-top,
  class: pt,
  values: $spacers
),
"padding-end": (
  responsive: true,
  property: padding-right,
  class: pe,
  values: $spacers
),
"padding-bottom": (
  responsive: true,
  property: padding-bottom,
  class: pb,
  values: $spacers
),
"padding-start": (
  responsive: true,
  property: padding-left,
  class: ps,
  values: $spacers
),
// Gap utility
"gap": (
  responsive: true,
  property: gap,
  class: gap,
  values: $spacers
),
"row-gap": (
  responsive: true,
  property: row-gap,
  class: row-gap,
  values: $spacers
),
"column-gap": (
  responsive: true,
  property: column-gap,
  class: column-gap,
  values: $spacers
),