rustedf.cloud
Menu

Número de página, cabeçalho e rodapé em PDF com HTML e CSS

Publicado em 2 min de leitura

Na tela, uma página não tem fim. Num PDF tem: toda folha precisa de um número de página, e os documentos longos costumam querer um título corrente ou um aviso de “Confidencial” em cada página. No CSS isso se faz com a regra @page e as suas caixas de margem, e o gerador do rustedf.cloud as suporta.

Página X de Y

@page {
size: A4;
margin: 20mm;
@bottom-center { content: "Página " counter(page) " de " counter(pages); }
}
  • size define o papel (A4, A4 landscape ou um tamanho em medidas) e margin o espaço em volta do conteúdo.
  • @bottom-center é uma caixa de margem: um espaço na margem de todas as páginas. O seu content é texto, unido a counter(page) para a página atual e a counter(pages) para o total.

Você não conta as páginas. O total só é conhecido depois que o documento inteiro foi montado, e os contadores são preenchidos para você.

Cabeçalho e rodapé com três espaços cada

As caixas de margem existem na borda superior e na inferior, cada uma com um espaço à esquerda, um no centro e um à direita.

@page {
size: A4;
margin: 24mm 20mm;
@top-left { content: "Acme Ltda."; }
@top-center { content: "Relatório trimestral"; }
@top-right { content: counter(page) " / " counter(pages); }
@bottom-left { content: "Confidencial"; }
@bottom-right { content: "Impresso " counter(page); }
}

Deixe a margem grande o bastante para o que você põe nela. Uma margem de poucos milímetros não tem espaço para um cabeçalho.

O que cabe numa caixa de margem

As caixas de margem aceitam texto e os dois contadores de página. Isso cobre os casos comuns: número de página, título do documento, nome da empresa, uma nota legal.

Para algo mais rico em todas as páginas, use o que mais se repete:

  • a linha de cabeçalho de uma tabela, que o gerador repete em cada página que a tabela ocupa, de modo que o título de uma coluna ou uma etiqueta curta acompanha os dados;
  • o conteúdo do corpo, para o que só precisa aparecer uma vez, como um logotipo na primeira página.

Um rodapé só para impressão

As regras dentro de @media print valem para o PDF. Coloque ali os elementos de página se a mesma folha de estilo também serve na tela, para que a visão no navegador continue limpa.

Confira

Gere um documento longo o bastante para ocupar duas páginas e olhe o resultado. O cabeçalho X-Pages de uma geração, e o valor pages de POST /v1/validate, dizem quantas páginas há sem abrir o arquivo. Se uma caixa de margem não faz efeito, valide o documento: tudo o que o gerador não suportou aparece na lista.

Leia mais em HTML e CSS suportados e em Validar um documento.

← Todos os posts