CSS свойство page-break-inside

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

CSS свойство page-break-inside определяет наличие или отсутствие разрыва страницы внутри заданного элемента при печати документа.

Свойство действует в контексте фрагментации: например, в многоколоночной раскладке или при печати. Обычный экранный блок без такого контекста не показывает разрывов. Запрет разрыва может быть нарушен, если содержимое не помещается целиком.

Для нового кода используйте break-inside. Старое page-break-inside сохранено как совместимый псевдоним для разрывов страниц.

Попробуйте значения page-break-inside

Это свойство проверяется в печати. Нажмите «Открыть печать примера» и сравните разбиение на страницы A5. Экранная область показывает только документ; она не имитирует страницы. Это прежнее имя свойства разрывов.

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

page-break-inside: auto

HTML и CSS примера
HTML
<div class="sheet">
  <div class="lead">Вступление занимает часть первой страницы.</div>
  <div class="demo-target">
    <p>
      Первый абзац объясняет разбиение содержимого. Текст переходит в следующую
      колонку, когда заканчивается доступная высота.
    </p>
    <p>
      Второй абзац содержит несколько строк, чтобы можно было сравнить перенос
      целого блока и его разделение.
    </p>
    <p>
      Первый абзац объясняет разбиение содержимого. Текст переходит в следующую
      колонку, когда заканчивается доступная высота.
    </p>
    <p>
      Второй абзац содержит несколько строк, чтобы можно было сравнить перенос
      целого блока и его разделение.
    </p>
  </div>
  <p>Конец документа.</p>
</div>
CSS
body {
  display: block;
  background: white;
  font: 16px/1.5 system-ui;
  color: #172c3d;
}
.sheet {
  max-width: 600px;
  margin: auto;
}
.lead {
  height: 130mm;
  background: #edf2f5;
}
.demo-target {
  background: #fff3d6;
  page-break-inside: auto;
}
p {
  margin: 0 0 8px;
}
@page {
  size: A5;
  margin: 15mm;
}
@media print {
  body {
    padding: 0;
    min-height: 0;
    display: block;
  }
  .sheet {
    max-width: none;
  }
}

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

Устарела

Спецификация: CSS break

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

Показать браузеры
Совместимостьcss.properties.page-break-inside
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
page-break-inside✓1✓12✓19✓7✓1.3✓18✓19✓14✓1✓1.0✓4.4✓1
auto✓1✓12✓19✓15✓1.3✓18✓19✓14✓1✓1.0✓4.4✓1
avoid✓1✓12✓19

Версия 19 выпущена в 2013 г.

Примечание MDN (англ.)

Until Firefox 25, page-break-inside: avoid did not work with the height of a block.

✓15✓1.3✓18✓19

Версия 19 выпущена в 2013 г.

Примечание MDN (англ.)

Until Firefox for Android 25, page-break-inside: avoid did not work with the height of a block.

✓14✓1✓1.0✓4.4✓1

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

CSS синтаксис:

CSS
page-break-inside: auto | avoid;

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

| — выбор варианта.

JavaScript синтаксис:

JavaScript
element.style.pageBreakInside = "avoid";

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

auto.

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

Значения page-break-inside
Значение Описание
auto Разрыв страниц внутри элемента (при печати) происходит в автоматическом режиме (при необходимости). Начальное значение.
avoid Запрещает при печати разрыв страниц внутри элемента (если возможно).
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для ненаследуемого свойства page-break-inside устанавливает его начальное значение.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

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

CSS Paged Media — спецификация page-break-inside.

Наследуется

Нет.

Анимируемое

Тип анимации — дискретный: значение переключается без плавных промежуточных положений.

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

Чтобы увидеть разрывы страниц, скачайте HTML кнопкой в редакторе, откройте файл в браузере и вызовите печать (Ctrl+P). Встроенный просмотр показывает обычный документ без разбиения на страницы. После изменения CSS скачайте файл заново.

Карточка без разрыва страницы: попробуйте сами

При печати карточка переносится целиком на следующую страницу. Сравните avoid и auto при формате A4 и масштабе 100%.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    color: #24364b;
    font:
        16px/1.5 Arial,
        sans-serif;
}
section {
    padding: 12px;
    border: 1px solid #70869c;
}
section + section {
    margin-top: 16px;
}
h1,
h2 {
    margin: 0 0 12px;
    font-size: 20px;
}
p {
    margin: 0 0 12px;
}
p:last-child {
    margin-bottom: 0;
}
@media print {
    body {
        margin: 0;
        color: #000;
    }
}
index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Карточка без разрыва страницы</title>
  </head>
  <body>
    <section class="intro">
      <h1>План занятия</h1>
      <p>В печатной версии этот раздел занимает большую часть первой страницы.</p>
    </section>
    <section class="card">
      <h2>Практическое задание</h2>
      <p>1. Создайте HTML-документ.</p>
      <p>2. Добавьте стили для печати.</p>
      <p>3. Проверьте расположение карточки.</p>
      <p>Конец задания.</p>
    </section>
  </body>
</html>
style.css
CSS
/* Фиксируем формат, чтобы карточка оказалась возле конца страницы. */
@page {
    size: A4;
    margin: 20mm;
}
@media print {
    .intro {
        height: 220mm;
    }
    .card {
        /* Сравните с auto: карточка сможет разделиться между страницами. */
        page-break-inside: avoid;
    }
}