Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@page — tamanho e margens da página impressa

A regra @page controla tamanho, orientação, margens e caixas marginais das páginas produzidas por media paginados.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

@page <page-selector-list> {
  <page-body>
}

@page <page-selector-list>? { <declaration-rule-list> } visa a caixa da página, não um elemento DOM. O descritor size escolhe formato, orientação ou duas dimensões; as margens estabelecem a área de conteúdo. Um seletor pode conter um nome atribuído por page e pseudoclasses como :left, :right, :first ou :blank.

Uma regra nomeada aplica-se apenas a fragmentos atribuídos a esse nome. :left e :right dependem do sentido de encadernação, não significam sempre números pares ou ímpares. Uma só dimensão é inválida para size; duas dimensões explícitas têm de ser positivas. Declarações não suportadas no contexto são ignoradas.

Regras marginais internas podem gerar cabeçalhos, rodapés ou contadores. As caixas ocupam as margens, pelo que uma margem pequena limita o espaço. O exemplo define uma página esquerda 100mm 50mm e lê o CSSPageRule, seletor, tamanho e margem reais; o efeito completo só aparece em media paginados.

Exemplos

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'));

Resultado

rule=CSSPageRule; selector=chapter:left; size=100mm 50mm; margin=10mm

A regra @page controla tamanho, orientação, margens e caixas marginais das páginas produzidas por media paginados.

Fontes