Comment utiliser les options de rendu

This article was translated from English: Does it need improvement?
Translated
View the article in English

par Chaknith Bin

Les options de rendu dans la génération de PDF se réfèrent aux paramètres et configurations qui déterminent comment un document PDF est créé, affiché et imprimé. Ces options peuvent inclure une large gamme de paramètres, tels que le rendu des éléments des champs de formulaire, l'activation de JavaScript, la génération d'une table des matières, l'ajout d'en-têtes et de pieds de page, l'ajustement des marges, la définition de la taille du papier PDF, et plus encore.

La classe ChromePdfRenderer dans IronPDF offre diverses options de rendu qui permettent aux utilisateurs de personnaliser la manière dont les PDF sont générés. Il comprend PaperFit, un gestionnaire qui contrôle la disposition du contenu sur les pages PDF, offrant différents styles de mise en page tels que les mises en page CSS3 réactives ou le flux continu.

Commencez avec IronPDF

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer



Exemple d'options de rendu

Bien que de nombreuses propriétés d'options de rendu soient spécifiquement conçues pour la conversion HTML en PDF, elles peuvent également être utilisées dans d'autres types de conversions PDF. Rendons la syntaxe Markdown en PDF et utilisons les options de rendu pour configurer le résultat PDF.

:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<h1>Header Content</h1>"
};
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);
renderer.RenderingOptions.MarginTop = 0;

// Markdown string
string md = "This is some **bold** and *italic* text.";

// Render from markdown string
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the PDF
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer As New ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header Content</h1>"}
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)
renderer.RenderingOptions.MarginTop = 0

' Markdown string
Dim md As String = "This is some **bold** and *italic* text."

' Render from markdown string
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)

' Save the PDF
pdf.SaveAs("renderingOptions.pdf")
VB   C#

Toutes les options de rendu

Nous disposons d'options avancées qui définissent les options de rendu du PDF, comme l'ajustement des marges,

l'orientation du papier, le format du papier, etc.

Le tableau ci-dessous illustre les nombreuses options possibles.

ClasseChromePdfRenderer
DescriptionPermet de définir les options d'impression du PDF, comme la taille du papier, le DPI, les en-têtes et les pieds de page
Propriétés / fonctionsTypeDescription
Cookies personnalisésDictionnaire<string, string> ;Cookies personnalisés pour le rendu HTML. Les cookies ne persistent pas entre les rendus et doivent être définis à chaque fois.
PaperFitGestionnaire de mise en page virtuelleUn gestionnaire pour configurer des mises en page de papier virtuel, contrôlant la façon dont le contenu sera mis en page sur les pages PDF "papier". Inclut des options pour le comportement par défaut de Chrome, le zoom, les mises en page CSS3 réactives, la mise à l'échelle de la page et l'alimentation continue des pages PDF.
Utiliser les marges sur l'en-tête et le pied de pageUtiliser les margesUtiliser les valeurs de marge du document principal lors du rendu des en-têtes et des pieds de page.
Créer des formulaires PDF à partir de HTMLboolTransforme tous les éléments de formulaire HTML en formulaires PDF éditables. La valeur par défaut est true.
CssMediaTypePdfCssMediaTypeActive les styles et feuilles de style CSS Media="screen". La valeur par défaut est PdfCssMediaType.Screen.
CustomCssUrlchaîne de caractèresPermet d'appliquer une feuille de style CSS personnalisée au code HTML avant le rendu. Il peut s'agir d'un chemin d'accès à un fichier local ou d'une URL distante. Uniquement applicable lors du rendu de HTML en PDF.
ActiverJavaScriptboolPermet l'exécution de JavaScript et de JSON avant le rendu de la page. Idéal pour l'impression à partir d'applications Ajax / Angular. La valeur par défaut est false.
ActiverMathematicalLaTexboolPermet le rendu des éléments mathématiques LaTeX.
Javascriptchaîne de caractèresUne chaîne JavaScript personnalisée à exécuter après le chargement de tout le code HTML, mais avant le rendu du PDF.
JavascriptMessageListenerDélégué de chaîneUne méthode de rappel à invoquer chaque fois qu'un message de console JavaScript du navigateur est disponible.
Numéro de la première pageintPremier numéro de page à utiliser dans les en-têtes et pieds de page du PDF. La valeur par défaut est 1.
Table des matièresTypes de table des matièresGénère une table des matières à l'endroit du document HTML où un élément est trouvé avec l'id "IronPDF-toc".
Échelle de grisboolProduit un PDF en noir et blanc. La valeur par défaut est false.
TextHeaderITextHeaderFooterDéfinit le contenu du pied de page de chaque page PDF sous forme de texte, prend en charge le "mail-merge" et transforme automatiquement les URL en hyperliens.
Pied de page
HtmlHeaderHtmlHeaderFooterDéfinit le contenu de l'en-tête de chaque page PDF en HTML. Prend en charge la fusion de courriers électroniques.
HtmlFooter
InputEncodingEncodageL'encodage des caractères d'entrée sous forme de chaîne. La valeur par défaut est Encoding.UTF8.
MarginTopdoubleMarge "papier" supérieure du PDF en millimètres. La valeur zéro est utilisée pour les applications d'impression sans bordure et les applications commerciales. La valeur par défaut est 25.
Droit à la margedoubleMarge "papier" droite du PDF en millimètres. La valeur zéro est utilisée pour les applications d'impression sans bordure et les applications commerciales. La valeur par défaut est 25.
MarginBottomdoubleMarge "papier" inférieure du PDF en millimètres. La valeur zéro est utilisée pour les applications d'impression sans bordure et les applications commerciales. La valeur par défaut est 25.
MargeGauchedoubleMarge "papier" gauche du PDF en millimètres. La valeur zéro est utilisée pour les applications d'impression sans bordure et les applications commerciales. La valeur par défaut est 25.
Orientation du papierPdfPaperOrientationOrientation du papier PDF, par exemple Portrait ou Paysage. La valeur par défaut est Portrait.
Taille du papierPdfPaperSizeDéfinit le format du papier
SetCustomPaperSizeinCentimeters (Définir la taille personnalisée du papier en centimètres)doubleDéfinit le format du papier en centimètres.
SetCustomPaperSizeInInchesDéfinit le format du papier en pouces.
SetCustomPaperSizeinMilimeters (Définir la taille du papier personnalisé en millimètres)Définit le format du papier en millimètres.
SetCustomPaperSizeinPixelsOrPoints (Définir la taille personnalisée du papier en pixels ou en points)Définit la taille du papier en pixels d'écran ou en points d'imprimante.
PrintHtmlBackgroundsBooléenIndique si les couleurs d'arrière-plan et les images doivent être imprimées à partir du code HTML. La valeur par défaut est true.
RequestContextDemandeContextesContexte de la demande pour ce rendu, déterminant l'isolement de certaines ressources telles que les cookies.
Délai d'attenteEntierDélai de rendu en secondes. La valeur par défaut est 60.
TitreChaîneMétadonnées de nom et de titre du document PDF, utiles pour la fusion de courrier et le nommage automatique des fichiers dans les extensions IronPDF MVC et Razor.
ForcePaperSizeBooléenForce la taille des pages à correspondre exactement à ce qui est spécifié via IronPdf.ChromePdfRenderOptions.PaperSize en redimensionnant la page après avoir généré un PDF à partir de HTML. Aide à corriger les petites erreurs de taille de page lors de la conversion de HTML en PDF.
AttendreAttendreUn objet enveloppant qui contient la configuration du mécanisme d'attente permettant aux utilisateurs d'attendre certains événements avant d'effectuer le rendu. Par défaut, il n'attend rien.
Chaknith related to Toutes les options de rendu

Chaknith Bin

Ingénieur logiciel

Chaknith est le Sherlock Holmes des développeurs. C'est en s'amusant à relever des défis de code qu'il s'est rendu compte pour la première fois qu'il pourrait avoir un avenir dans le domaine de l'ingénierie logicielle. Il se concentre sur IronXL et IronBarcode, mais il est fier d'aider les clients avec chaque produit. Chaknith tire parti des connaissances qu'il a acquises en discutant directement avec les clients pour améliorer les produits eux-mêmes. Ses commentaires anecdotiques vont au-delà des tickets Jira et soutiennent le développement de produits, la documentation et le marketing, afin d'améliorer l'expérience globale des clients.Quand il n'est pas au bureau, on peut le trouver en train d'apprendre sur l'apprentissage automatique, le codage et la randonnée.