间距实用程序

Bootstrap 包括各种快捷响应式外边距(margin)、内边距(padding)和间隙实用程序类，用于修改元素的外观。

内容提要

外边距(margin)和内边距(padding)

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

使用 CSS 网格布局模块？考虑使用 gap 实用程序。

表示法

适用于所有断点的间距实用程序，从 xs 到 xxl，它们不包括断点的缩写。这是因为这些类应用到从 min-width: 0 及以上的所有宽度，因此不受媒体查询的约束。但是，其余断点需要包含断点缩写。

使用格式 {property}-{sides}-{size} 命名类。对于适用于某个断点的类，格式为 {property}-{sides}-{breakpoint}-{size} 其中 breakpoint 为 xs、 sm、md、lg、xl 和 xxl。

其中 property 是以下之一：

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

其中 sides 是以下之一：

t - 用于设置 margin-top 或 padding-top 的类
b - 用于设置 margin-bottom 或 padding-bottom 的类
s - (start) 用于在 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 - 用于清除 margin 或 padding 的类，方法是将其设置为 0
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 设置为 auto 的类

（您可以通过向 $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 类，用于水平居中固定宽度的块级内容——即具有 display: block 和 width 的内容。设置——通过将水平边距(margins)设置为 auto。

Centered element

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

负 margin

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

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

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

间距(Gap)

使用 display: grid 时，您可以使用父网格容器上的 gap 实用程序。这可以省去向每个网格项（display:grid 容器的子项）添加边距实用程序的麻烦。 Gap 实用程序默认是响应式的，并且是通过我们的实用程序 API 生成的，基于 $spacers Sass 映射。

Grid item 1

Grid item 2

Grid item 3

<div class="d-grid gap-3">
  <div class="p-2 bg-light border">Grid item 1</div>
  <div class="p-2 bg-light border">Grid item 2</div>
  <div class="p-2 bg-light border">Grid item 3</div>
</div>

支持包括所有 Bootstrap 网格断点的响应选项，以及 $spacers 映射 (0–5) 中的六种尺寸。没有 .gap-auto 实用程序类，因为它实际上与 .gap-0 相同。

Sass

映射

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

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

$negative-spacers: if($enable-negative-margins, negativify-map($spacers), null);

实用程序 API

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

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