rustedf.cloud
Menu

Quebra de página em PDF com CSS: blocos e tabelas sem cortes

Publicado em 2 min de leitura

Uma página de navegador rola, então ninguém percebe onde um bloco termina. Em um PDF, a página termina onde o papel acaba, e o padrão é cortar onde o conteúdo estiver. É assim que uma assinatura vai parar sozinha na página três, ou um total fica longe da sua tabela. O CSS tem propriedades para isso, e o gerador do rustedf.cloud as suporta.

Começar algo em uma página nova

.termos { break-before: page; }
.capa { break-after: page; }

break-before e break-after forçam uma quebra antes ou depois de um elemento. Os nomes mais antigos, page-break-before: always e page-break-after: always, também funcionam. Use-os para uma capa, ou para termos e condições que devem sempre abrir uma página nova.

Manter um bloco inteiro

.assinatura,
.totais,
.cartao { break-inside: avoid; }

break-inside: avoid pede ao gerador que leve um bloco para a página seguinte em vez de dividi-lo. É a ferramenta certa para um bloco de assinatura, uma caixa de totais ou um cartão.

Para manter um título junto do parágrafo que vem depois, envolva os dois em um único elemento e coloque break-inside: avoid nesse invólucro, para que um título não fique sozinho no fim de uma página.

Uma tabela pequena pode ser mantida inteira do mesmo jeito, com break-inside: avoid na própria tabela.

Tabelas longas

Uma tabela longa precisa ser dividida. O gerador a continua na página seguinte e repete a linha de cabeçalho em cada página que a tabela ocupa, de modo que o leitor não precise voltar para lembrar o que uma coluna significa. Coloque os títulos das colunas em um <thead>:

<table>
<thead>
<tr><th>Item</th><th>Qtd.</th><th>Valor</th></tr>
</thead>
<tbody>
{% for line in lines %}
<tr><td>{{ line.name }}</td><td>{{ line.qty }}</td><td>{{ line.amount }}</td></tr>
{% endfor %}
</tbody>
</table>

Linhas na borda da página

Mais duas propriedades controlam linhas soltas de um parágrafo. orphans é o mínimo de linhas que ficam no fim de uma página, e widows o mínimo levado para a seguinte.

p { orphans: 3; widows: 3; }

O gerador aplica o controle de viúvas e órfãs, para que um parágrafo não deixe uma linha solitária no topo ou no fim de uma página.

Quando um bloco não pode ser dividido

break-inside: avoid não ajuda um bloco mais alto que a página. Uma caixa com altura fixa maior que o papel, ou conteúdo pintado fora dele, é reportada como LayoutOverflow pela validação. Deixe um bloco assim crescer com o conteúdo, em vez de fixar a altura.

Confira o resultado

O número de páginas de uma geração está no cabeçalho de resposta X-Pages, e POST /v1/validate o devolve como pages sem usar crédito. Gere um documento com os dados mais longos que fizerem sentido, porque é ali que as quebras aparecem.

Veja HTML e CSS suportados e Validar um documento.

← Todos os posts