Внутренний отступ
Классы p-* задают свойство padding — пространство между содержимым и
краем элемента. Фон и рамка элемента захватывают эту область. Берите их для
карточек, кнопок, ячеек и любых блоков, где содержимому нужен воздух до
границы.
Пример
Шкала отступов
Пунктирная рамка — элемент с классом, тёмный блок — его содержимое. Светлая полоса между ними — внутренний отступ.
p-0
p-1/4
p-1/2
p-1
p-2
p-3
p-4
Одна сторона или ось
p-top-* и p-bottom-* задают отступ сверху и снизу,
p-inline-start-* и p-inline-end-* — в начале и в конце строки, p-x-* и
p-y-* — сразу по обе стороны строчной или блочной оси.
p-top-3
p-bottom-3
p-inline-start-3
p-inline-end-3
p-x-3
p-y-3
Начало и конец строки
Стороны inline-start и inline-end следуют направлению текста: при
dir="rtl" начало строки справа, и отступ переходит туда же.
dir="ltr" · p-inline-start-5
dir="rtl" · p-inline-start-5
Фиксированная шкала
Классы вида p-a4, p-c4 берут размер из шкалы --sf-a0 … --sf-i9 и
не меняются с шириной экрана.
p-a4
p-b0
p-b8
p-c4
p-d0
Ширина экрана
С префиксом ширины класс действует от указанной ширины и шире. Меняйте
ширину окна просмотра: начиная с ширины md отступ внутри рамки растёт.
Классы
| Класс | CSS | Значения |
|---|---|---|
p-{значение} |
padding: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-top-{значение} |
padding-top: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-inline-end-{значение} |
padding-inline-end: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-bottom-{значение} |
padding-bottom: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-x-{значение} |
padding-inline-start: var(--sf-space-{значение}); padding-inline-end: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-y-{значение} |
padding-top: var(--sf-space-{значение}); padding-bottom: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-inline-start-{значение} |
padding-inline-start: var(--sf-space-{значение}) |
0, 1/4, 1/3, 1/2, 1, 2, 3, 4, 5, 6, 7, 8 |
p-{значение} |
padding: var(--sf-{значение}) |
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, e0, e1, e2, e3, e4, e5, e6, e7, e8, e9, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, g0, g1, g2, g3, g4, g5, g6, g7, g8, g9, h0, h1, h2, h3, h4, h5, h6, h7, h8, h9, i0, i1, i2, i3, i4, i5, i6, i7, i8, i9 |
p-top-{значение} |
padding-top: var(--sf-{значение}) |
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, e0, e1, e2, e3, e4, e5, e6, e7, e8, e9, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, g0, g1, g2, g3, g4, g5, g6, g7, g8, g9, h0, h1, h2, h3, h4, h5, h6, h7, h8, h9, i0, i1, i2, i3, i4, i5, i6, i7, i8, i9 |
p-inline-end-{значение} |
padding-inline-end: var(--sf-{значение}) |
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, e0, e1, e2, e3, e4, e5, e6, e7, e8, e9, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, g0, g1, g2, g3, g4, g5, g6, g7, g8, g9, h0, h1, h2, h3, h4, h5, h6, h7, h8, h9, i0, i1, i2, i3, i4, i5, i6, i7, i8, i9 |
p-bottom-{значение} |
padding-bottom: var(--sf-{значение}) |
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, e0, e1, e2, e3, e4, e5, e6, e7, e8, e9, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, g0, g1, g2, g3, g4, g5, g6, g7, g8, g9, h0, h1, h2, h3, h4, h5, h6, h7, h8, h9, i0, i1, i2, i3, i4, i5, i6, i7, i8, i9 |
p-inline-start-{значение} |
padding-inline-start: var(--sf-{значение}) |
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, d0, d1, d2, d3, d4, d5, d6, d7, d8, d9, e0, e1, e2, e3, e4, e5, e6, e7, e8, e9, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, g0, g1, g2, g3, g4, g5, g6, g7, g8, g9, h0, h1, h2, h3, h4, h5, h6, h7, h8, h9, i0, i1, i2, i3, i4, i5, i6, i7, i8, i9 |
Условия (что это): ширина экрана — sm:, md:, lg:, xl:, xxl:; состояния — нет. Например: sm:p-0.
Классы и переменные собраны из CSS выпуска и обновляются вместе с ним.
Переменные
Классы читают эти токены темы. Изменённый токен меняет все места, где он используется, — классы, компоненты и тему; задайте его в теме проекта, а не на отдельном элементе. Все токены — на странице Все токены.
| Переменная | Значение по умолчанию |
|---|---|
--sf-space-0 |
0 |
--sf-space-1/4 |
0.25rem; от ширины lg: var(--sf-a4) |
--sf-space-1/3 |
0.5rem; от ширины lg: var(--sf-a8) |
--sf-space-1/2 |
0.5rem; от ширины lg: 0.75rem |
--sf-space-1 |
var(--sf-b2); от ширины lg: var(--sf-b6) |
--sf-space-2 |
var(--sf-b6); от ширины lg: var(--sf-c0) |
--sf-space-3 |
var(--sf-b6); от ширины lg: var(--sf-c2) |
--sf-space-4 |
var(--sf-c2); от ширины lg: var(--sf-c6) |
--sf-space-5 |
var(--sf-c6); от ширины lg: var(--sf-d0) |
--sf-space-6 |
var(--sf-c6); от ширины lg: var(--sf-d2) |
--sf-space-7 |
var(--sf-d0); от ширины lg: var(--sf-d6) |
--sf-space-8 |
var(--sf-d2); от ширины lg: var(--sf-e0) |
--sf-a0 |
0rem |
--sf-a1 |
0.0625rem |
--sf-a2 |
0.125rem |
--sf-a3 |
0.1875rem |
--sf-a4 |
0.25rem |
--sf-a5 |
0.3125rem |
--sf-a6 |
0.375rem |
--sf-a7 |
0.4375rem |
--sf-a8 |
0.5rem |
--sf-a9 |
0.5625rem |
--sf-b0 |
0.625rem |
--sf-b1 |
0.6875rem |
--sf-b2 |
0.75rem |
--sf-b3 |
0.8125rem |
--sf-b4 |
0.875rem |
--sf-b5 |
0.9375rem |
--sf-b6 |
1rem |
--sf-b7 |
1.0625rem |
--sf-b8 |
1.125rem |
--sf-b9 |
1.1875rem |
--sf-c0 |
1.25rem |
--sf-c1 |
1.375rem |
--sf-c2 |
1.5rem |
--sf-c3 |
1.625rem |
--sf-c4 |
1.75rem |
--sf-c5 |
1.875rem |
--sf-c6 |
2rem |
--sf-c7 |
2.125rem |
--sf-c8 |
2.25rem |
--sf-c9 |
2.375rem |
--sf-d0 |
2.5rem |
--sf-d1 |
2.75rem |
--sf-d2 |
3rem |
--sf-d3 |
3.25rem |
--sf-d4 |
3.5rem |
--sf-d5 |
3.75rem |
--sf-d6 |
4rem |
--sf-d7 |
4.25rem |
--sf-d8 |
4.5rem |
--sf-d9 |
4.75rem |
--sf-e0 |
5rem |
--sf-e1 |
5.5rem |
--sf-e2 |
6rem |
--sf-e3 |
6.5rem |
--sf-e4 |
7rem |
--sf-e5 |
7.5rem |
--sf-e6 |
8rem |
--sf-e7 |
8.5rem |
--sf-e8 |
9rem |
--sf-e9 |
9.5rem |
--sf-f0 |
10rem |
--sf-f1 |
11rem |
--sf-f2 |
12rem |
--sf-f3 |
13rem |
--sf-f4 |
14rem |
--sf-f5 |
15rem |
--sf-f6 |
16rem |
--sf-f7 |
17rem |
--sf-f8 |
18rem |
--sf-f9 |
19rem |
--sf-g0 |
20rem |
--sf-g1 |
22rem |
--sf-g2 |
24rem |
--sf-g3 |
26rem |
--sf-g4 |
28rem |
--sf-g5 |
30rem |
--sf-g6 |
32rem |
--sf-g7 |
34rem |
--sf-g8 |
36rem |
--sf-g9 |
38rem |
--sf-h0 |
40rem |
--sf-h1 |
44rem |
--sf-h2 |
48rem |
--sf-h3 |
52rem |
--sf-h4 |
56rem |
--sf-h5 |
60rem |
--sf-h6 |
64rem |
--sf-h7 |
68rem |
--sf-h8 |
72rem |
--sf-h9 |
76rem |
--sf-i0 |
80rem |
--sf-i1 |
88rem |
--sf-i2 |
96rem |
--sf-i3 |
104rem |
--sf-i4 |
112rem |
--sf-i5 |
120rem |
--sf-i6 |
128rem |
--sf-i7 |
136rem |
--sf-i8 |
144rem |
--sf-i9 |
152rem |
В CSS косую черту в имени экранируют: var(--sf-space-1\/4).
Применение
Какую шкалу выбрать
Основная шкала p-0 … p-8 читает токены --sf-space-*. Они согласованы
с m-*, gap-* и space-* и подрастают от ширины lg. Шаги шкалы на
узком экране частично совпадают: 1/3 и 1/2, 2 и 3, 5 и 6 дают
одинаковый отступ.
Фиксированная шкала (p-a0 … p-i9) нужна, когда отступ должен совпасть с
размером из той же шкалы и не меняться с шириной экрана. У неё есть
p-{размер} и четыре стороны, но нет осевых классов p-x-* и p-y-*.
Стороны
Для отступа слева и справа используйте inline-start, inline-end или
p-x-*: тогда разметка без правок работает в языках с письмом справа
налево.
<div class="p-2">Карточка</div>
<button type="button" class="p-x-3 p-y-1">Кнопка</button>
<div class="p-top-4 p-inline-end-1/2">Разные стороны</div>
<div class="p-e2">Отступ из фиксированной шкалы</div>
Отступ по ширине экрана
<section class="p-2 md:p-4">
Плотнее на узком экране, просторнее от ширины md
</section>
Ограничения
- Отрицательных внутренних отступов нет: значение
paddingне бывает меньше нуля. - У семейств нет префиксов состояния:
hover:p-1и подобные классы не существуют.