printElements
printElements copied to clipboard
luxonauta
🖨️ A JavaScript library to easily print content from web pages.
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.
luxonauta