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.
Continue lendo
Layout do PDF
QR code e código de barras em PDF gerado a partir de HTML
Desenhe um QR code ou um código de barras Code 128 em um ingresso, etiqueta ou fatura com um filtro do template. Tamanhos, limites e entradas inválidas.
2 min de leitura
Layout do PDF
Número de página, cabeçalho e rodapé em PDF com HTML e CSS
Coloque "Página 2 de 5", um título corrente e um aviso de confidencial em todas as páginas de um PDF com a regra @page do CSS. Exemplos e o que conferir.
2 min de leitura
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura