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

Chaknith Bin
Chaknith Bin
octobre 12, 2023
Mise à jour février 19, 2025
Partager:
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 d'affichage CSS réactive pour la taille de papier spécifiée est interprétée en fonction de la largeur de cette taille de papier. Utilisez la méthode UseChromeDefaultRendering pour configurer cela.

: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")
$vbLabelText   $csharpLabel

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.

Le CSS réactif est utilisé pour définir le rendu du HTML en fonction du paramètre ViewPortWidth, en adaptant le contenu pour s'ajuster à la largeur de la taille de papier spécifiée.

: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")
$vbLabelText   $csharpLabel

Rendu à l'échelle

La méthode UseScaledRendering adopte une mise en page qui imite le comportement de 'Chrome Print Preview' pour une taille de papier spécifiée. Elle offre également un niveau de zoom supplémentaire que les développeurs peuvent ajuster manuellement. Cette méthode permet l'option de mettre à l'échelle le contenu selon le pourcentage de zoom d'entrée.

: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")
$vbLabelText   $csharpLabel

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")
$vbLabelText   $csharpLabel

Rendu en continu

Le rendu en continu permet de créer un PDF d'une seule page dont la largeur et la hauteur du contenu tiennent 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. Rendons le fichier 'receipt.html' en PDF.

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")
$vbLabelText   $csharpLabel
Chaknith Bin
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il possède une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, une documentation améliorée et une expérience globale enrichie.