html2pdf Rupture de Page Fixée en C# (Tutoriel Développeur)

IronPDF : La bibliothèque PDF C

IronPDF est une bibliothèque PDF C# flexible, facile à utiliser et hautement personnalisable qui permet aux développeurs, débutants ou expérimentés, de manipuler et éditer complètement les PDFs. Elle fournit de nombreuses façons pour les développeurs de convertir différents formats, tels que HTML, RTF et Images, en PDFs et d'éditer davantage comment il est rendu lors de la conversion en PDF. De plus, IronPDF utilise un moteur de rendu Chrome et, en tant que tel, est hautement compétent dans le rendu de chaînes HTML, et il permet aux développeurs d'utiliser le stylage CSS pour personnaliser davantage le document HTML, offrant aux développeurs un avantage en termes de personnalisation et de présentation visuelle que vous ne trouverez nulle part ailleurs.

Étant donné que la bibliothèque utilise un moteur de rendu Chrome, ce que vous voyez est ce que vous obtenez lors du rendu HTML, ce qui la rend idéale pour des opérations telles que la création de modèles pour les sauts de page afin qu'il n'y ait pas de décalages par rapport aux modèles. C'est précisément comme vous l'avez conçu lorsque vous les convertissez en PDFs.

Ajout de saut de page sur PDF

Pour illustrer la flexibilité et la facilité d'utilisation de la bibliothèque, nous utiliserons un exemple de code montrant comment vous ajouteriez des sauts de page de manière programmatique.

Dans ce scénario, nous utiliserons un PDF basé sur un tableau comme entrée, et nous verrons la différence entre ajouter le saut de page immédiatement et après pour plus de clarté visuelle.

// 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> <!-- Ensures a page break after the table -->
  <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> <!-- Ensures a page break after the table -->
  <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
Private 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> <!-- Ensures a page break after the table -->
  <img src='https://ironpdf.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Create an instance of ChromePdfRenderer
Private renderer = New ChromePdfRenderer()

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

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

Contrôler les sauts de page avec CSS

Comme IronPDF peut être personnalisé avec CSS, car il utilise un moteur de rendu Chrome, nous pouvons tirer parti de cela et utiliser CSS pour ajouter des sauts de page à des éléments spécifiques et des sauts de page à l'intérieur de ceux-ci, ainsi que spécifier quel élément ne doit pas avoir de saut de page à l'intérieur.

Par exemple, bien que dans l'image ci-dessus, le saut de page se produise après le tableau, il peut y avoir des moments où il se produit à l'intérieur du tableau en raison de l'encombrement.

Pour éviter cela, nous pouvons utiliser un stylage CSS spécifique pour le nœud et spécifier que nous ne voulons pas ajouter de saut de page à l'intérieur.

<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>

Ajouter page-break-inside: avoid empêche les sauts de page à l'intérieur de l'élément. Cependant, lors de cette opération, assurez-vous que cela est appliqué au nœud div parent de l'élément.

Une opération similaire peut également être utilisée pour les éléments où vous souhaitez ajouter un style page-break-before.

<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>

Étant donné que nous pouvons utiliser HTML, nous pouvons spécifier davantage les éléments des nœuds en explorant l'arborescence des nœuds HTML à l'aide de document.getElementById de JavaScript pour sélectionner l'élément par son ID et garantir que chaque nœud est entièrement personnalisable.

Optimisation de la qualité d'image et de la taille du fichier

Le paramètre de saut de page est également étroitement lié à la qualité de l'image. Vous voulez vous assurer que le paramètre de saut de page n'affecte pas la qualité de l'image en la rétrécissant ou en la redimensionnant sur la page suivante.

Ainsi, nous pouvons utiliser le CSS pour garantir que la qualité de l'image est cohérente dans les modèles lorsque nous appliquons des sauts de page.

<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>

Le stylage CSS ci-dessus garantit que l'image est cohérente après les opérations de saut de page. Nous réglons d'abord la largeur à 100% de la page, et la hauteur peut être redimensionnée automatiquement pour maintenir le rapport hauteur/largeur.

De plus, IronPDF dispose d'options de rendu supplémentaires lors de la gestion des HTML, similaires aux paramètres d'impression d'un utilisateur pour les invites de téléchargement de PDF imprimables. Pour une liste complète des attributs, veuillez vous référer à la documentation API.

Contrepartie utilisant JavaScript

Étant donné qu'IronPDF a l'avantage d'utiliser un moteur de rendu Chrome, il est également accompagné d'une version Node.js qui permet aux développeurs de divers horizons d'utiliser cette puissante bibliothèque.

Avec la variante Node.js, les développeurs ont un contrôle encore plus précis sur l'ajout de sauts de page, car vous avez accès à une utilisation basée sur des promesses et à des méthodes, telles que la méthode de promesse onRejected pour le débogage ou le suivi de la progression, ainsi que ses fonctions intermédiaires.

Comparé à une bibliothèque courante comme html2pdf avec sa méthode de sortie de l'objet jsPDF, IronPDF est plus flexible et prend en charge plusieurs langues, permettant aux développeurs ayant des compétences linguistiques différentes de travailler sur le même projet.

Conclusion

Comprendre comment utiliser les sauts de page et comment le CSS affecte l'ensemble du HTML est crucial pour créer des documents présentables et visuellement attrayants pour les utilisateurs. Cela permet aux lecteurs de séparer l'information qu'ils lisent pour éviter une surcharge d'information et de la confusion. Tout au long de cet article, nous avons parlé de l'utilisation du puissant moteur de rendu Chrome qu'IronPDF utilise pour créer automatiquement des modèles de saut de page pour les modèles et l'automatisation, rationalisant l'efficacité et la scalabilité lors de la création de ces documents ainsi que réduisant le risque d'erreur humaine.

Pour les développeurs qui souhaiteraient essayer IronPDF, la bibliothèque offre un essai gratuit pour $799 et plus.