Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła