Spacing(间距)
Bootstrap 提供范围广泛的简写响应式边距、填充和间隙实用程序类来修改元素的外观。
边距和填充
使用辅助类将响应式的 margin
或 padding
值分配给元素或其旁边的子集。包括对单个属性、所有属性以及垂直和水平属性的支持。类是从默认的 Sass 映射构建的,范围从 .25rem
到 3rem
.
用法
适用于所有断点(从xs
到xxl
)的间距实用程序中没有断点缩写。这是因为这些类是从min-width: 0
自上而下应用的,因此不受媒体查询的约束。但是,其余断点确实包含断点缩写。
这些类使用{property}{sides}-{size}
的命名格式,默认对应xs
尺寸,{property}{sides}-{breakpoint}-{size}
格式对应 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
- 空 - 用于在元素的所有 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
为auto
(您可以通过向Sass 映射变量$spacers
添加条目来生成更多尺寸。)
例子
以下是这些类的一些代表性示例:
.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
集的内容——通过将水平边距设置为auto
.
<div class="mx-auto" 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
实用程序。这可以节省为网格或弹性容器的各个子容器添加边距实用程序的麻烦。Gap 实用程序默认是响应式的,并且是通过我们的实用程序 API $spacers
基于Sass 映射生成的。
<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
指定容器中子项之间的垂直间距。
<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
指定容器中子项之间的水平间距。
<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 映射声明,然后使用我们的实用程序 API 生成。
$spacer: 1rem;
$spacers: (
0: 0,
1: $spacer * .25,
2: $spacer * .5,
3: $spacer,
4: $spacer * 1.5,
5: $spacer * 3,
);
实用程序接口
间距实用程序在我们的实用程序 API scss/_utilities.scss
中声明。了解如何使用实用程序 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
),
// 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
),