printElements

A JavaScript library to easily print content from web pages.

Motivation

Creating a print-ready PDF from web content can be tricky and time-consuming. This library simplifies the process, allowing you to print only the content you need with minimal fuss.

Features

Select specific HTML tags within a specified container for printing;
Exclude elements with a designated class from the print output;
Handles dynamic DOM environments by ensuring the print operation is only executed when the DOM is fully accessible;
Provides flexibility with configurable delay options to manage different rendering times.

Quick Start

Via CDN

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/gh/luxonauta/printElements@latest/dist/printElements.min.css"
/>

<script
  src="https://cdn.jsdelivr.net/gh/luxonauta/printElements@latest/dist/printElements.min.js"
  crossorigin="anonymous"
/>

Or download it directly from the GitHub repository.

Usage

Wrap the content to be printed within a <main> tag. Then call printElements(options) with your specified options:

<!doctype html>
<html lang="en">
  <head>
    <link rel="stylesheet" href="path/to/printElements.min.css" />
  </head>
  <body>
    <main>
      <h1>Your Content Here</h1>
      <!-- Additional content -->
    </main>
    <button id="printBtn">Print</button>
    <script src="path/to/printElements.min.js"></script>
    <script>
      document.addEventListener("DOMContentLoaded", () => {
        const printOptions = {
          targets: ["index.html"],
          tags: ["h1", "p", "li"],
          willNotPrint: "exclude",
          wrapper: "main",
          delay: 150 // Optional delay in milliseconds before printing
        };

        document.getElementById("printBtn").onclick = () =>
          printElements(printOptions);
      });
    </script>
  </body>
</html>

wrapper: Specify the container element whose contents you want to print (default is "main");
willNotPrint: Apply the class "exclude" to any HTML element within the wrapper to prevent it from being printed;
delay: Customize the delay in milliseconds before the print command is executed, to ensure all content is rendered properly.

License

Released under the MIT License. You are free to use and modify it for your projects.