CSS свойство border-spacing

Определение и применение

CSS свойство border-spacing задает расстояние между границами соседних ячеек.

Попробуйте значения border-spacing

Таблица использует border-collapse: separate. Одно значение задаёт оба промежутка; два — сначала горизонтальный, затем вертикальный.

Значение свойства

border-spacing: 0

HTML и CSS примера
HTML
<table class="demo-target">
  <caption>
    Расписание занятий
  </caption>
  <thead>
    <tr>
      <th>Раздел</th>
      <th>Тема</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>HTML</td>
      <td>Таблицы</td>
    </tr>
    <tr>
      <td>CSS</td>
      <td></td>
    </tr>
    <tr>
      <td>JavaScript</td>
      <td>События</td>
    </tr>
  </tbody>
</table>
CSS
.demo-target {
  width: 100%;
  max-width: 320px;
  border: 3px solid #245a85;
  border-collapse: separate;
  background: #fff3d6;
  color: #172c3d;
  font: 16px/1.4 system-ui;
  border-spacing: 0;
}
th,
td {
  padding: 8px;
  border: 2px solid #245a85;
  background: #d9edf8;
}
th {
  background: #b9d7eb;
}
caption {
  padding: 8px;
  font-weight: 600;
}

Поддержка браузерами

Спецификация: css2

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьcss.properties.border-spacing
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
border-spacing✓1✓12✓1✓4✓1✓18✓4✓14✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

CSS синтаксис:

CSS
border-spacing: <length [0,∞]>{1,2};

/* Глобальные значения */
border-spacing: initial | inherit | unset | revert | revert-layer;

[ ] — группа, а внутри типа — допустимый диапазон; {1,2} — число повторений от 1 до 2; ∞ — отсутствие верхней границы.

JavaScript синтаксис:

JavaScript
element.style.borderSpacing = "15px 15px";

Начальное значение свойства

0.

Значения свойства

Значения border-spacing
Значение Описание
length length Задает расстояние между границами соседних ячеек в единицах измерения CSS (px, cm, em и др). Отрицательные значения не допускаются.
  • Если указано одно значение длины, то оно указывает интервалы как по горизонтали, так и вертикали.
  • Если указаны два значения длины, то первое определяет горизонтальное расстояние, а второе вертикальное.
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для наследуемого свойства border-spacing наследует вычисленное значение у родительского элемента.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

Переход между двумя значениями border-spacing показывает плавное изменение обеих длин.

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

CSS Table — спецификация border-spacing.

Наследуется

Да.

Анимируемое

Да, по вычисленному значению: горизонтальный и вертикальный промежутки интерполируются как длины.

Примеры, попробуйте сами

Расстояние между ячейками

В варианте A одинаковые промежутки по обеим осям. В B первое значение задаёт расстояние по горизонтали, второе — по вертикали. Поменяйте 16px и 4px местами, затем попробуйте border-collapse: collapse — промежутки исчезнут.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.4 system-ui,
        sans-serif;
    color: #172c3d;
}
.comparison {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(min(100%, 200px), 1fr));
    gap: 24px;
}
h3 {
    margin: 0 0 12px;
    font-size: 16px;
}
table {
    width: 100%;
    border: 2px solid #35658a;
    background: #eef2f5;
}
th,
td {
    padding: 8px;
    border: 2px solid #35658a;
    text-align: left;
    background: #d6e5f0;
}
caption {
    padding: 8px 0;
    font-weight: bold;
}
index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Расстояние между ячейками</title>
  </head>
  <body>
    <div class="comparison">
      <section>
        <h3>Вариант A</h3>
        <table class="sample first">
          <caption>
            Покупки
          </caption>
          <thead>
            <tr>
              <th scope="col">Товар</th>
              <th scope="col">Штук</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td>Яблоки</td>
              <td>3</td>
            </tr>
            <tr>
              <td>Груши</td>
              <td>2</td>
            </tr>
          </tbody>
        </table>
      </section>
      <section>
        <h3>Вариант B</h3>
        <table class="sample second">
          <caption>
            Покупки
          </caption>
          <thead>
            <tr>
              <th scope="col">Товар</th>
              <th scope="col">Штук</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td>Яблоки</td>
              <td>3</td>
            </tr>
            <tr>
              <td>Груши</td>
              <td>2</td>
            </tr>
          </tbody>
        </table>
      </section>
    </div>
  </body>
</html>
style.css
CSS
.sample {
    border-collapse: separate;
}
.first {
    border-spacing: 8px;
}
.second {
    border-spacing: 16px 4px;
}

Плавное изменение промежутков таблицы

Включите флажок: горизонтальный промежуток растёт до 24px, вертикальный — до 12px. Снимите флажок, чтобы увидеть обратный переход. При border-collapse: collapse промежутки не видны.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Плавное изменение промежутков таблицы</title>
  </head>
  <body>
    <input id="wide" type="checkbox" /><label for="wide">Увеличить промежутки</label>
    <table>
      <tbody>
        <tr>
          <td>А</td>
          <td>Б</td>
        </tr>
        <tr>
          <td>В</td>
          <td>Г</td>
        </tr>
      </tbody>
    </table>
  </body>
</html>
style.css
CSS
table {
    border-collapse: separate;
    border-spacing: 2px;
    transition: border-spacing 1s;
}
td {
    border: 1px solid;
    padding: 8px;
}
#wide:checked ~ table {
    border-spacing: 24px 12px;
}