страница
Свойство page CSS используется для указания именованной страницы, определённого типа страницы, заданного с помощью @page правила.
Если есть несколько селекторов, последовательно использующих именованную страницу, может потребоваться принудительный разрыв страницы с помощью break-after.
Синтаксис
/* set a named page */ page: exampleName; page: chapterIntro; /* Use ancestors named page */ page: auto; /* default value */ /* Global values */ page: inherit; page: initial; page: revert; page: revert-layer; page: unset;
Значения
auto-
Значение по умолчанию. Используется значение ближайшего предка с отличным от
autoзначением. Если у предка нет установленного значения именованной страницы, используемое значение для auto — пустая строка. <custom-ident>-
Чувствительное к регистру имя, определённое в правиле
@page.
Формальное определение
| Начальное значение | auto |
|---|---|
| Применимо к | блочным элементам в обычном потоке корневого элемента. Веб-браузеры могут также применить его к другим элементам, таким как table-row элементы. |
| Наследуется | нет |
| Вычисленное значение | как указано |
| Тип анимации | дискретный |
Формальный синтаксис
page =
auto |
<custom-ident>
Примеры
Пример с именованной страницей
HTML
Этот HTML состоит из двух частей:
- Управление печатью
- Печатаемый контент
Управление печатью позволяет пользователю выбрать способ печати section в article.
<!-- print options -->
<fieldset id="printStyle">
<legend>How would you like to print</legend>
<label for="single"
><input type="radio" id="single" name="type" value="single" checked />No
Pages</label
>
<label for="double"
><input type="radio" id="grouped" name="type" value="grouped" />Pages with
Grouped Chapters</label
>
<label for="double"
><input type="radio" id="paged" name="type" value="paged" />Chapters
Paged</label
>
<button id="print">Print</button>
</fieldset>
<!-- Content to be printed -->
<article id="print-area" data-print="single">
<section id="toc">
<h2>Table of contents</h2>
<ul>
<li>Foreword</li>
<li>Introduction</li>
<li>Chapter One - named pages</li>
<li>Chapter Two - page orientation</li>
<li>Chapter Three - page margins</li>
<li>Conclusion</li>
</ul>
</section>
<section id="foreword">
<h2>Foreword</h2>
<p>
This book is all about how the CSS <code>@page</code> at-rule can help
with printing HTML books.
</p>
</section>
<section id="introduction">
<h2>Introduction</h2>
<p>
This book is a concept to show how an <em>HTML</em> document can easily be
printed out in pages.
</p>
</section>
<section id="chapter1" class="chapter">
<h2>Named pages</h2>
<p>Lorem ipsum</p>
</section>
<section id="chapter2" class="chapter">
<h2>Page Orientation</h2>
<p>Lorem ipsum</p>
</section>
<section id="chapter3" class="chapter">
<h2>Page Margins</h2>
<p>There are 16 page margins that can be set:</p>
<ul>
<li>@top-left-corner</li>
<li>@top-left</li>
<li>@top-center</li>
<li>@top-right</li>
<li>@top-right-corner</li>
<li>@left-top</li>
<li>@left-middle</li>
<li>@left-bottom</li>
<li>@right-top</li>
<li>@right-middle</li>
<li>@right-bottom</li>
<li>@bottom-left-corner</li>
<li>@bottom-left</li>
<li>@bottom-center</li>
<li>@bottom-right</li>
<li>@bottom-right-corner</li>
</ul>
<p>They can be used to show what appears in these parts of the margin</p>
</section>
<section id="conclusion">
<h2>Conclusion</h2>
<p>Now go ahead and write books.</p>
</section>
</article>
CSS
Первая часть CSS настраивает **именованные** страницы, включая размер, ориентацию и содержимое для области @top-center отступа печатных страниц.
@page toc {
size: a4 portrait;
@top-center {
content: "Table of contents";
}
}
@page foreword {
size: a4 portrait;
@top-center {
content: "Foreword";
}
}
@page introduction {
size: a4 portrait;
@top-center {
content: "Introduction";
}
}
@page conclusion {
size: a4 portrait;
@top-center {
content: "Conclusion";
}
}
@page chapter {
size: a4 landscape;
@top-center {
content: "Chapter";
}
}
Следующая часть CSS использует селекторы атрибутов для применения размеров, ориентации и отступов, определённых в именованных @page правилах, заданных в предыдущем разделе CSS, к элементам, использующим свойство page.
Разделы с class="chapter" находятся в одном потоке и отображаются как одна страница. break-after: page; используется для разделения их, разделяя каждый раздел на отдельную печатную страницу.
@media print {
fieldset {
display: none;
}
section {
font-size: 2rem;
font-family: Roboto;
}
.chapter {
border: tomato 2px solid;
}
[data-print="grouped"] > #toc,
[data-print="paged"] > #toc {
page: toc;
font-family: Courier;
}
[data-print="grouped"] > #foreword,
[data-print="paged"] > #foreword {
page: foreword;
font-family: Courier;
}
[data-print="grouped"] > #introduction,
[data-print="paged"] > #introduction {
page: introduction;
font-family: Courier;
}
[data-print="grouped"] > #conclusion,
[data-print="paged"] > #conclusion {
page: conclusion;
font-family: Courier;
}
[data-print="grouped"] > .chapter,
[data-print="paged"] > .chapter {
page: chapter;
}
[data-print="paged"] > .chapter {
border: none;
break-after: page;
}
.chapter > ul {
columns: 2;
}
}
JavaScript
JavaScript обновляет значение атрибута data-print, к которому применяется именованная страница, при выборе другого варианта печати:
const printArea = document.querySelector("#print-area");
const printButton = document.querySelector("#print");
const printOption = document.querySelector("#printStyle");
printOption.addEventListener("change", (event) => {
if (event.target.value === "single") {
printArea.dataset.print = "single";
} else if (event.target.value === "grouped") {
printArea.dataset.print = "grouped";
} else {
printArea.dataset.print = "paged";
}
});
printButton.addEventListener("click", () => {
window.print();
});
Результат
Печатаемый контент и отображение в диалоговом окне предварительного просмотра печати будут изменяться в зависимости от выбранной радиокнопки стилей печати.
Спецификации
| Спецификация |
|---|
| CSS Paged Media Module Level 3 # using-named-pages |
Совместимость с браузерами
| Десктоп | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
page |
85 | 85 | 110 | 71 | ≤13.1 | 85 | 110 | 60 | ≤13.4 | 14.0 | 85 |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/page