
本教程将详细介绍一种利用 javascript 和 data uri 技术,实现网页中特定 html 元素(如收据)打印到 pdf 或纸张的有效方法。该方案避免了传统隐藏/显示 dom 元素的繁琐操作,通过动态生成包含目标内容的独立 html 页面并在新窗口中触发打印,提供了一种更优雅、更专业的局部打印解决方案,并涵盖了 html 结构准备、javascript 逻辑实现及相关注意事项。
在构建现代 Web 应用时,经常会遇到需要打印页面中特定区域(例如购物收据、报告片段或特定表格)的需求。传统的做法可能是通过 JavaScript 动态隐藏页面上除目标内容之外的所有元素,然后触发 window.print(),打印完成后再恢复元素的显示状态。这种方法不仅操作繁琐,容易导致页面闪烁,用户体验不佳,而且在复杂页面结构下维护成本较高。
本教程将介绍一种更为优雅和高效的解决方案:利用 JavaScript 动态创建包含目标内容的新 HTML 页面,并通过 Data URI 的形式在新窗口中打开并立即触发打印。这种方法能够将打印内容完全隔离,避免了对当前页面 DOM 结构的干扰,实现了干净、专业的局部打印效果。
为了实现特定元素的局部打印,我们需要确保目标内容及其相关的样式是自包含的。这意味着所有的样式信息最好能随同目标 HTML 片段一起被复制。一个推荐的做法是将目标内容包裹在一个独立的容器中,并且其特有的样式可以直接内联或嵌入在容器内部。
以下是一个示例的收据 HTML 结构,为了便于打印,我们将其包裹在一个 <section> 标签中,并且将相关的 CSS 样式也一并包含在内:
立即学习“前端免费学习笔记(深入)”;
<section class="receipt-section">
<table class="receipt">
<style>
/* 收据专属样式 */
.receipt {
border-collapse: collapse;
max-width: 80%;
font-family: sans-serif;
/* 初始状态不居中,等待JS动态注入 */
}
.receipt td {
padding: .5em;
}
.receipt tr:nth-child(even) {
border: 1px solid #333;
border-inline: none;
background: #ddd;
}
.receipt tr:nth-child(odd) {
background: #fff
}
.header-Uprice,
.item-Uprice,
.header-qty,
.item-qty {
text-align: center
}
.total {
border-bottom: 3px double #000
}
</style>
<tr class="table-headers">
<td class="header-id">#</td>
<td class="header-desc">Item Description</td>
<td class="header-Uprice">Unit Price</td>
<td class="header-qty">Qty</td>
<td class="header-price">Price</td>
</tr>
<tr class="item" id="1">
<td class="item-id">1</td>
<td class="item-desc">Dummy Item1</td>
<td class="item-Uprice">200$</td>
<td class="item-qty">1</td>
<td class="item-price">200$</td>
</tr>
<tr class="item" id="2">
<td class="item-id">2</td>
<td class="item-desc">Dummy Item2</td>
<td class="item-Uprice">75$</td>
<td class="item-qty">1</td>
<td class="item-price">75$</td>
</tr>
<tr class="item" id="3">
<td class="item-id">3</td>
<td class="item-desc">Dummy Item3</td>
<td class="item-Uprice">100$</td>
<td class="item-qty">2</td>
<td class="item-price">200$</td>
</tr>
<tr class="total">
<td>Total</td>
<td></td>
<td></td>
<td></td>
<td>475$</td>
</tr>
</table>
</section>关键点:
核心的打印逻辑将通过一个 JavaScript 函数 printReceipt() 来实现。这个函数负责捕获目标 HTML、动态注入打印指令和额外样式,然后在一个新的空白页面中展示并触发打印。
function printReceipt() {
// 1. 获取包含收据的整个区域的HTML内容
const receiptSection = document.querySelector('.receipt-section');
if (!receiptSection) {
console.error('未找到收据区域元素 (.receipt-section)。');
return;
}
let receiptHTML = receiptSection.innerHTML;
// 2. 准备动态注入的CSS样式,用于打印前的居中显示
// 注意:这里使用了转义字符来确保字符串正确解析
const cssCenteringScript = `
const styleTag = document.querySelector('.receipt > style');
if (styleTag) {
styleTag.innerHTML += '.receipt { position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); margin: 0; }';
}
`;
// 3. 注入一个脚本到收据HTML中,使其在新页面加载后自动执行打印和居中样式
// 这个脚本将在新窗口加载完成后立即运行
const printScript = `<script>
window.onload = () => {
${cssCenteringScript} // 注入居中样式
window.print(); // 触发打印
// 可选:打印后关闭当前窗口,但需注意浏览器安全策略可能阻止
// setTimeout(() => window.close(), 100);
};
</script>`;
// 将打印脚本添加到收据HTML的末尾
receiptHTML += printScript;
// 4. 将处理后的HTML内容编码为 Data URI
const URI = 'data:text/html,' + encodeURIComponent(receiptHTML);
// 5. 在新窗口中打开 Data URI,这将加载并显示收据内容,并自动触发打印
// '_blank' 表示在新标签页或新窗口中打开
window.open(URI, '_blank');
}代码解析:
为了让用户能够触发打印,我们可以将 printReceipt 函数绑定到一个按钮的点击事件上。
<!-- 在你的HTML中添加一个打印按钮 -->
<button class="printButton">打印收据</button>
<script>
// 获取按钮元素
const button = document.querySelector('.printButton');
// 为按钮添加点击事件监听器
if (button) {
button.addEventListener('click', printReceipt);
} else {
console.warn('未找到打印按钮 (.printButton)。');
}
</script>通过利用 JavaScript 和 Data URI 技术,我们能够实现一种优雅、高效且不干扰原始页面 DOM 的局部内容打印方案。这种方法特别适用于需要打印特定、自包含文档片段(如收据、票据等)的场景。虽然它可能不是处理所有打印需求的终极解决方案,但对于许多常见的 Web 打印任务来说,它提供了一个简洁且功能强大的替代方案,避免了传统方法中“隐藏-打印-显示”的繁琐操作,从而提升了开发效率和用户体验。
以上就是前端局部打印:避免 DOM 隐藏/显示,优雅地打印指定 HTML 片段的详细内容,更多请关注php中文网其它相关文章!
HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号