CKTIS / CSS
@page — format i marginesy strony drukowanej
Reguła @page określa rozmiar, orientację, marginesy i pola marginesowe stron tworzonych przez mechanizm paginacji.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
@page <page-selector-list> {
<page-body>
}@page <page-selector-list>? { <declaration-rule-list> } dotyczy pudełka strony, nie elementu DOM. Deskryptor size wybiera nazwany format, orientację albo parę wymiarów, a właściwości marginesów wyznaczają obszar treści. Selektor może zawierać nazwę ustawioną przez właściwość page oraz pseudoklasy stron, na przykład :left, :right, :first lub :blank.
Nazwana reguła działa tylko dla fragmentów przypisanych do tej nazwy. :left i :right zależą od kierunku oprawy, nie od nieparzystości numeru w każdym dokumencie. size o jednym wymiarze jest niepoprawny; dwa wymiary muszą być dodatnie. Deklaracje nieobsługiwane w kontekście strony są ignorowane bez stylizowania zwykłego elementu.
Wewnątrz @page można umieszczać reguły pól marginesowych, które generują nagłówki, stopki lub liczniki stron. Ich pudełka mieszczą się w marginesach, więc zbyt mały margines ogranicza dostępne miejsce. Przykład definiuje nazwaną lewą stronę o wymiarach 100mm 50mm, odczytuje rzeczywisty CSSPageRule, selektor, rozmiar i margines; pełny efekt układu jest widoczny dopiero w paged media.
Przykłady
const style = document.createElement('style');
style.textContent = '@page chapter:left { size: 100mm 50mm; margin: 10mm; }';
document.head.append(style);
const rule = style.sheet.cssRules[0];
console.log('rule=' + rule.constructor.name + '; selector=' + rule.selectorText + '; size=' + rule.style.getPropertyValue('size') + '; margin=' + rule.style.getPropertyValue('margin'));Wynik
rule=CSSPageRule; selector=chapter:left; size=100mm 50mm; margin=10mm
Reguła @page określa rozmiar, orientację, marginesy i pola marginesowe stron tworzonych przez mechanizm paginacji.