Comment utiliser la fenêtre de visualisation virtuelle et le zoom

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

Dans le rendu HTML vers PDF, la fenêtre de visualisation joue un rôle essentiel en déterminant la manière dont la présentation de la page web sera capturée dans le document PDF qui en résultera. Plus précisément, il s'agit de la taille de l'écran virtuel sur lequel le navigateur doit afficher la page web.

Le zoom, dans le contexte du rendu HTML vers PDF, régit la mise à l'échelle du contenu de la page web dans le document PDF. La possibilité de régler avec précision le niveau de zoom permet d'ajuster la taille du contenu dans le PDF résultant, en veillant à ce qu'il soit conforme à la mise en page et au formatage souhaités.

Commencez avec IronPDF

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

Première étape :
green arrow pointer



Modes d'ajustement du papier

Accédez au champ PaperFit dans RenderingOptions pour invoquer une méthode prédéfinie qui peut être utilisée pour un type et un mode de rendu spécifiques. Examinons chaque mode de PaperFit plus en détail en reproduisant la page Wikipedia bien connue à des fins de comparaison.

Rendu par défaut de Chrome

Les pages PDF sont présentées de la même manière qu'elles apparaissent dans l'aperçu avant impression de Google Chrome. Cette méthode configure les options de rendu pour imiter l'apparence d'une page web lorsqu'elle est imprimée à partir de l'aperçu avant impression de Google Chrome. La fenêtre CSS réactive pour le format de papier spécifié est interprétée en fonction de la largeur de ce format de papier. Utilisez la méthode UseChromeDefaultRendering pour configurer ceci.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("chromeDefault.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("chromeDefault.pdf")
VB   C#

Rendu CSS réactif

En mode CSS réactif, vous pouvez spécifier une largeur de fenêtre en passant une valeur à la méthode UseResponsiveCssRendering. La largeur par défaut de la fenêtre est de 1280 pixels. Comme vous l'avez peut-être remarqué, l'unité viewport est basée sur les pixels, représentant une fenêtre virtuelle du navigateur pour les conceptions CSS réactives.

Responsive CSS est utilisé pour définir le rendu du HTML en fonction du paramètre ViewPortWidth, mettant à l'échelle le contenu pour l'adapter à la largeur du format de papier spécifié.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-responsive-css.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("responsiveCss.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("responsiveCss.pdf")
VB   C#

Rendu à l'échelle

La méthode UseScaledRendering adopte une disposition qui imite le comportement de 'Chrome Print Preview' pour un format de papier spécifié. Elle fournit également un niveau de zoom supplémentaire que les développeurs peuvent ajuster manuellement. Cette méthode active l'option de mise à l'échelle du contenu en fonction du pourcentage de zoom saisi.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-scaled.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("scaled.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("scaled.pdf")
VB   C#

Adapter le rendu à la page

À l'inverse, le rendu "adapté à la page" adapte le contenu au format de papier spécifié. Il mesure la largeur minimale du contenu HTML après le rendu et l'adapte, dans la mesure du possible, à la largeur d'une feuille de papier. La largeur minimale configurable est utilisée comme largeur minimale basée sur les pixels pour le document afin d'assurer un affichage correct et une réactivité aux règles de mise en page CSS3.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-fit-to-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("fitToPage.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("fitToPage.pdf")
VB   C#

Rendu en continu

Le rendu en continu crée un PDF d'une seule page qui fait tenir l'ensemble du contenu en largeur et en hauteur sur une seule page, ce qui convient à des documents tels que des factures ou des reçus de consommateurs. La largeur par défaut de la page PDF est de 80,0 millimètres et la marge par défaut est de 5 millimètres.

La possibilité de personnaliser la largeur et la marge de la page à l'aide des paramètres "width" et "margin" offre une grande flexibilité, ce qui en fait un choix pratique pour créer des documents concis d'une seule page.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-continuous-feed.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

int width = 90;
int margin = 0;

// Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("receipt.html");

pdf.SaveAs("continuousFeed.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private width As Integer = 90
Private margin As Integer = 0

' Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("receipt.html")

pdf.SaveAs("continuousFeed.pdf")
VB   C#