Correção de quebra de página em html2pdf em C# (Tutorial para desenvolvedores)

IronPDF: A biblioteca PDF em C

IronPDF é uma biblioteca C# para PDF flexível, fácil de usar e altamente personalizável, que permite a desenvolvedores, iniciantes ou veteranos, manipular e editar PDFs completamente. Oferece aos desenvolvedores diversas maneiras de converter diferentes formatos, como HTML, RTF e imagens, em PDFs, além de permitir a edição da forma como o arquivo é renderizado durante a conversão para PDF. Além disso, o IronPDF utiliza um mecanismo de renderização do Chrome e, como tal, é altamente eficiente na renderização de strings HTML, permitindo que os desenvolvedores usem estilos CSS para personalizar ainda mais o documento HTML, oferecendo uma vantagem em termos de personalização e apresentação visual que você não encontrará em nenhum outro lugar.

Como a biblioteca utiliza um mecanismo de renderização do Chrome, o que você vê é o que você obtém ao renderizar HTML, o que a torna ideal para operações como a criação de modelos para quebras de página, evitando incompatibilidades entre os modelos. É exatamente assim que você projetou os modelos ao convertê-los em PDFs.

Adicionando quebra de página em PDF

Para ilustrar a flexibilidade e a facilidade de uso da biblioteca, utilizaremos um exemplo de código que mostra como adicionar quebras de página programaticamente.

Neste cenário, usaremos um PDF baseado em tabela como entrada e veremos a diferença entre adicionar a quebra de página imediatamente e depois, para maior clareza visual.

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

' Replace the license key variable with the trial key you obtained
IronPdf.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

using IronPdf; // Import the IronPdf library

// Define the HTML content, including a table and an image
const string html = @"
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Create an instance of ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// Render the HTML content into a PDF
var pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf");

Imports IronPdf ' Import the IronPdf library

' Define the HTML content, including a table and an image
Const html As String = "
  <table style='border: 1px solid #000000'>
    <tr>
      <th>Company</th>
      <th>Product</th>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronPDF</td>
    </tr>
    <tr>
      <td>Iron Software</td>
      <td>IronOCR</td>
    </tr>
  </table>
  <div style='page-break-after: always;'> </div> 
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Create an instance of ChromePdfRenderer
Dim renderer As New ChromePdfRenderer()

' Render the HTML content into a PDF
Dim pdf = renderer.RenderHtmlAsPdf(html)

' Save the PDF as "Page_Break.pdf"
pdf.SaveAs("Page_Break.pdf")

Controlando quebras de página com CSS

Como o IronPDF pode ser personalizado com CSS, já que utiliza um mecanismo de renderização do Chrome, podemos aproveitar isso e usar CSS para adicionar quebras de página a elementos específicos e dentro deles, bem como especificar quais elementos não devem ter quebras de página.

Por exemplo, embora na imagem acima a quebra de página ocorra após a tabela, pode haver momentos em que ela aconteça dentro da tabela devido à sobreposição de elementos.

Para evitar isso, podemos usar estilos CSS específicos para o nó e especificar que não queremos adicionar uma quebra de página dentro dele.

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

<div style='page-break-inside: avoid'>
 <img src='no-break-me.png'>
</div>

Adicionar page-break-inside: avoid impede quebras de página dentro do elemento. No entanto, ao realizar essa operação, certifique-se de que ela seja aplicada ao nó div pai do elemento.

Uma operação semelhante também pode ser usada para elementos nos quais você deseja adicionar um estilo de quebra de página antes.

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

<div style="page-break-inside: avoid;">
    <img src="no-break-me.png">
</div>

Como podemos utilizar HTML, podemos especificar ainda mais os elementos dos nós, navegando pela árvore de nós HTML usando o document.getElementById do JavaScript para selecionar o elemento pelo seu ID e garantir que cada nó seja totalmente personalizável.

Otimizando a qualidade da imagem e o tamanho do arquivo

A configuração de quebra de página também está intimamente relacionada à qualidade da imagem. Você quer garantir que a configuração de quebra de página não afete a qualidade da imagem, diminuindo ou redimensionando-a na página seguinte.

Assim, podemos usar CSS para garantir que a qualidade da imagem seja consistente em todos os modelos quando aplicamos quebras de página.

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

<div class="no-break">
    <img src="optimized-image.jpg" alt="Optimized Image" style="width:100%; height:auto;">
</div>

O estilo CSS acima garante que a imagem permaneça consistente após quebras de página. Primeiro, definimos a largura para 100% da página e a altura pode ser ajustada automaticamente para manter a proporção.

Além disso, o IronPDF possui opções adicionais de renderização ao lidar com HTML, que são semelhantes às configurações de impressão do usuário para solicitações de PDF imprimíveis para download. Para obter uma lista completa dos atributos, consulte a documentação da API .

Contraparte usando JavaScript

Como o IronPDF tem a vantagem de usar um mecanismo de renderização do Chrome, ele também vem com uma versão Node.js que permite que desenvolvedores de diversas áreas utilizem essa poderosa biblioteca.

Com a variante Node.js , os desenvolvedores têm um controle ainda mais preciso sobre a adição de quebras de página, pois têm acesso ao uso e aos métodos baseados em promessas, como o método de promessa onRejected para depuração ou rastreamento de progresso, bem como suas funções intermediárias.

Em comparação com uma biblioteca comum como o html2pdf, com seu método de saída do objeto jsPDF , o IronPDF é mais flexível e suporta vários idiomas, permitindo que desenvolvedores com diferentes níveis de conhecimento em linguagens de programação trabalhem no mesmo projeto.

Conclusão

Compreender como usar quebras de página e como o CSS afeta o HTML como um todo é crucial para criar documentos apresentáveis ​​e visualmente atraentes para os usuários. Permite aos leitores separar as informações que estão lendo para evitar sobrecarga de informações e confusão. Ao longo deste artigo, falamos sobre a utilização do poderoso mecanismo de renderização do Chrome, que o IronPDF usa para criar modelos de quebra de página automaticamente para modelos e automação, otimizando a eficiência e a escalabilidade na criação desses documentos, além de reduzir o risco de erro humano.

Para desenvolvedores que gostariam de experimentar o IronPDF, a biblioteca oferece um período de avaliação gratuito para a versão $799 e superiores.