html2pdf Złamany punkt strony naprawiony w C# (Poradnik dla deweloperów)

IronPDF: biblioteka PDF dla języka C

IronPDF to elastyczna, łatwa w użyciu i wysoce konfigurowalna biblioteka C# do obsługi plików PDF, która pozwala programistom, zarówno początkującym, jak i doświadczonym, w pełni manipulować i edytować pliki PDF. Oferuje programistom wiele sposobów konwersji różnych formatów, takich jak HTML, RTF i obrazy, do plików PDF oraz dalszej edycji sposobu renderowania podczas konwersji do formatu PDF. Ponadto IronPDF wykorzystuje silnik renderujący Chrome, dzięki czemu doskonale radzi sobie z renderowaniem ciągów HTML i pozwala programistom na dalsze dostosowywanie dokumentów HTML za pomocą stylów CSS, zapewniając im przewagę w zakresie personalizacji i prezentacji wizualnej, której nie znajdziesz nigdzie indziej.

Ponieważ biblioteka wykorzystuje silnik renderujący Chrome, podczas renderowania HTML otrzymujesz dokładnie to, co widzisz, co sprawia, że idealnie nadaje się ona do takich operacji, jak tworzenie szablonów podziałów stron, dzięki czemu nie ma żadnych rozbieżności w stosunku do szablonów. Dokładnie tak zaprojektowałeś szablony podczas konwersji ich do formatu PDF.

Dodawanie podziału strony w pliku PDF

Aby zilustrować elastyczność i łatwość użytkowania biblioteki, posłużymy się przykładem kodu pokazującym, jak programowo dodać podziały stron.

W tym scenariuszu jako dane wejściowe wykorzystamy plik PDF w formie tabeli i dla większej przejrzystości zobaczymy różnicę między dodaniem podziału strony natychmiast a dodaniem go później.

// 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")

Kontrolowanie podziałów stron za pomocą CSS

Ponieważ IronPDF można dostosować za pomocą CSS, ponieważ wykorzystuje silnik renderujący Chrome, możemy to wykorzystać i użyć CSS do dodania podziałów stron do określonych elementów oraz podziałów stron wewnątrz nich, a także określić, który element nie powinien mieć podziału strony w swoim wnętrzu.

Na przykład, chociaż na powyższym obrazku podział strony następuje po tabeli, mogą zdarzyć się sytuacje, w których nastąpi on w obrębie tabeli z powodu zagęszczenia treści.

Aby tego uniknąć, możemy zastosować specjalny styl CSS dla elementu node i określić, że nie chcemy dodawać w nim podziału strony.

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

Dodanie page-break-inside: avoid zapobiega podziałom stron wewnątrz elementu. Jednak podczas wykonywania tej operacji upewnij się, że jest ona zastosowana do nadrzędnego węzła div elementu.

Podobną operację można również zastosować w przypadku elementów, do których chcesz dodać styl "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>

Ponieważ możemy korzystać z HTML, możemy jeszcze bardziej sprecyzować elementy węzłów, przeglądając drzewo węzłów HTML za pomocą JavaScript document.getElementById w celu wybrania elementu na podstawie jego identyfikatora i zapewnienia, że każdy węzeł jest w pełni konfigurowalny.

Optymalizacja jakości obrazu i rozmiaru pliku

Ustawienie podziału stron jest również ściśle związane z jakością obrazu. Należy upewnić się, że ustawienie podziału strony nie wpływa na jakość obrazu poprzez jego zmniejszenie lub skalowanie na następnej stronie.

W związku z tym możemy użyć CSS, aby zapewnić spójną jakość obrazów we wszystkich szablonach podczas stosowania podziałów stron.

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

Powyższy styl CSS zapewnia spójność obrazu po operacjach podziału strony. Najpierw ustawiamy szerokość na 100% strony, a wysokość może być automatycznie skalowana w celu zachowania proporcji.

Ponadto IronPDF oferuje dodatkowe opcje renderowania podczas obsługi HTML, które są podobne do ustawień drukowania użytkownika dla monitów dotyczących plików PDF do pobrania i wydruku. Pełna lista atrybutów znajduje się w dokumentacji API.

Odpowiednik wykorzystujący JavaScript

Ponieważ IronPDF ma tę zaletę, że korzysta z silnika renderującego Chrome, jest również dostępny w wersji Node.js, co pozwala programistom z różnych środowisk na korzystanie z tej potężnej biblioteki.

W przypadku wariantu Node.js programiści mają jeszcze większą kontrolę nad dodawaniem podziałów stron, ponieważ mają dostęp do metod opartych na obietnicach, takich jak metoda onRejected do debugowania lub śledzenia postępów, a także jej funkcji pośrednich.

W porównaniu z popularną biblioteką, taką jak html2pdf z metodą wyjściową obiektu jsPDF, IronPDF jest bardziej elastyczny i obsługuje wiele języków, umożliwiając programistom o różnej znajomości języków pracę nad tym samym projektem.

Wnioski

Zrozumienie, jak używać podziałów stron i jak CSS wpływa na ogólny kod HTML, ma kluczowe znaczenie dla tworzenia dokumentów, które są reprezentacyjne i atrakcyjne wizualnie dla użytkowników. Pozwala to czytelnikom na selekcjonowanie informacji, które czytają, aby uniknąć nadmiaru informacji i niejasności. W całym tym artykule mówiliśmy o wykorzystaniu potężnego silnika renderującego Chrome, którego IronPDF używa do automatycznego tworzenia szablonów podziałów stron dla szablonów i automatyzacji, usprawniając wydajność i skalowalność podczas tworzenia tych dokumentów, a także zmniejszając ryzyko błędu ludzkiego.

Dla programistów, którzy chcieliby wypróbować IronPDF, biblioteka oferuje bezpłatną wersję próbną dla $799 i wyższych.