间距(Spacing)

Bootstrap 包括各种速记响应边距、填充和间隙实用程序类，用于修改元素的外观。

当前页

边距和填充

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

使用 CSS 网格布局模块？ 请考虑改用间隙实用程序。

表示法

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

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

其中属性是以下之一：

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 -（end）对于在 LTR 中设置margin-right或padding-right，在 RTL 中设置margin-left或padding-left的类
x - 对于同时设置 *-left和*-right的类
y - 对于同时设置*-top 和*-bottom的类
blank - 对于在元素的所有 4 个边上设置margin或padding的类

其中 size 是以下之一：

0 - 对于通过将其设置为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设置为自动的类

（您可以通过向$spacersSass 映射变量添加条目来添加更多大小。）

示例

以下是这些类的一些代表性示例：

.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不能）。默认情况下，这些负边距是禁用的，但可以通过设置$enable-negative-margins: true在 Sass 中启用。

语法与默认的正边距实用程序几乎相同，但在请求的大小之前添加了n。下面是一个与.mt-1相反的示例类：

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

间隙（Gap）

使用display: grid或display: flex时，您可以在父元素上使用gap实用程序。这样可以省去向网格或弹性容器的各个子项添加边距实用程序。默认情况下，Gap 实用程序是响应式的，并且通过我们的实用程序 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）

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）

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>

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

Utilities API

间距实用程序在我们的实用程序 API 中的 scss/_utilities.scss中声明。了解如何使用实用程序 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
),