gap (grid-gap)

Свойство gap CSS задаёт отступы между колонками и рядами. Является сокращением для свойств row-gap и column-gap.

Интерактивный пример

Обратите внимание, что grid-gap является псевдонимом для этого свойства.

Синтаксис

css
/* One <length> value */
gap: 20px;
gap: 1em;
gap: 3vmin;
gap: 0.5cm;

/* One <percentage> value */
gap: 16%;
gap: 100%;

/* Two <length> values */
gap: 20px 10px;
gap: 1em 0.5em;
gap: 3vmin 2vmax;
gap: 0.5cm 2mm;

/* One or two <percentage> values */
gap: 16% 100%;
gap: 21px 82%;

/* calc() values */
gap: calc(10% + 20px);
gap: calc(20px + 10%) calc(10% - 5px);

/* Global values */
gap: inherit;
gap: initial;
gap: revert;
gap: revert-layer;
gap: unset;

Свойство задаёт значение для <'row-gap'>, за которым может следовать значение для <'column-gap'>. Если <'column-gap'> опущено, то оно устанавливается в то же значение, что и <'row-gap'>.

<'row-gap'> и <'column-gap'> могут быть заданы как <length>, так и <percentage>.

Значения

<length>

Размер отступа, разделяющего линии сетки.

<percentage>

Размер отступа, разделяющего линии сетки, относительно размера грид-элемента.

Формальное определение

Начальное значениекак и у каждого из подсвойств этого свойства:
Применяется кmulti-column elements, flex containers, grid containers
Наследуетсянет
Обработка значениякак и у каждого из подсвойств этого свойства:
  • row-gap: as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements
  • column-gap: as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements
Animation typeкак и у каждого из подсвойств этого свойства:

Формальный синтаксис

gap = 
<'row-gap'> <'column-gap'>?

<row-gap> =
normal |
<length-percentage [0,∞]>

<column-gap> =
normal |
<length-percentage [0,∞]>

<length-percentage> =
<length> |
<percentage>

Примеры

Флексбокс-раскладка

HTML

html
<div id="flexbox">
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
</div>

CSS

css
#flexbox {
  display: flex;
  flex-wrap: wrap;
  width: 300px;
  gap: 20px 5px;
}

#flexbox > div {
  border: 1px solid green;
  background-color: lime;
  flex: 1 1 auto;
  width: 100px;
  height: 50px;
}

Результат

Грид-раскладка

HTML

html
<div id="grid">
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
</div>

CSS

css
#grid {
  display: grid;
  height: 200px;
  grid-template: repeat(3, 1fr) / repeat(3, 1fr);
  gap: 20px 5px;
}

#grid > div {
  border: 1px solid green;
  background-color: lime;
}

Результат

Многоколоночная раскладка

HTML

html
<p class="content-box">
  This is some multi-column text with a 40px column gap created with the CSS
  <code>gap</code> property. Don't you think that's fun and exciting? I sure do!
</p>

CSS

css
.content-box {
  column-count: 3;
  gap: 40px;
}

Результат

Спецификации

Specification
CSS Box Alignment Module Level 3
# gap-shorthand

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также