列印功能看似簡單,實際專案中常面臨:只列印局部區域、隱藏導航/廣告、調整列印樣式、處理分頁斷行、跨瀏覽器相容等挑戰。本文系統整理三種主流方案,提供生產可用的程式碼與最佳實踐。
利用 CSS @media print 定義列印專用樣式,配合 window.print() 觸發列印對話框。
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>列印 Demo</title>
<style>
/* 螢幕樣式 */
.noprint { display: block; }
.print-only { display: none; }
.page-break { page-break-after: always; }
/* 列印樣式 */
@media print {
.noprint { display: none !important; } /* 隱藏導航、按鈕、廣告 */
.print-only { display: block !important; } /* 顯示僅列印內容 (如水印、版權) */
.page-break { page-break-after: always; } /* 強制分頁 */
body { font-size: 12pt; margin: 0; } /* 列印字體/邊距 */
a[href]::after { content: " (" attr(href) ")"; } /* 顯示連結網址 */
}
</style></head><body>
<button class="noprint" onclick="window.print()">列印本頁</button>
<div class="noprint">這行不會被列印</div>
<div class="print-only">機密文件 - 僅限內部列印</div>
<h1>報表標題</h1>
<div class="content">...大量內容...</div>
<div class="page-break"></div> <!-- 強制分頁 -->
<h1>續頁標題</h1>
<div class="content">...續頁內容...</div>
<script>
// 可選:列印前/後事件 (IE/Edge 支援有限)
window.onbeforeprint = () => console.log('準備列印');
window.onafterprint = () => console.log('列印完成/取消');
</script>
</body></html>
| 屬性 | 作用 | 值範例 |
|---|---|---|
page-break-before | 元素前強制分頁 | always, avoid, left, right |
page-break-after | 元素後強制分頁 | always, avoid |
page-break-inside | 避免元素內部分頁 | avoid (表格、卡片必加) |
@page | 頁面邊距/方向/尺寸 | @page { margin: 2cm; size: A4 landscape; } |
orphans/widows | 段落首尾行最少保留行數 | orphans: 3; widows: 3; |
原理:將目標區域複製到隱藏 <iframe>,觸發 iframe 列印,避免污染主頁面樣式。
<script src="jquery.min.js"></script>
<script src="jquery.PrintArea.js"></script> <!-- 需自行下載 -->
<button id="btn-print-area">列印報表區域</button>
<div id="report-area">
<h2>銷售報表</h2>
<table>...</table>
</div>
<script>
$('#btn-print-area').on('click', function () {
$('#report-area').printArea({
mode: 'iframe', // 'popup' 或 'iframe' (推薦 iframe)
popHt: 600, // popup 高度
popWd: 800, // popup 寬度
popTitle: '報表列印', // 標題
standard: 'html5', // 文件型別
extraCss: '/css/print-report.css', // 額外列印樣式
retainAttr: ['id', 'class', 'style'], // 保留屬性
onPrint: function () { console.log('列印觸發'); }
});
});
</script>
<iframe> 附加到 body。outerHTML 寫入 iframe document.body。extraCss 與頁面現有 <link rel="stylesheet" media="print">。iframe.contentWindow.print()。function printElement(elementId, options = {}) {
const el = document.getElementById(elementId);
if (!el) return;
const iframe = document.createElement('iframe');
iframe.style.cssText = 'position:absolute;width:0;height:0;border:none;left:-9999px;';
document.body.appendChild(iframe);
const doc = iframe.contentDocument || iframe.contentWindow.document;
// 複製樣式
const styles = Array.from(document.querySelectorAll('style, link[rel="stylesheet"]'))
.map(n => n.outerHTML).join('');
// 寫入內容
doc.write('' + styles +
(options.extraCss ? '' : '') +
'' + el.outerHTML + '');
doc.close();
iframe.onload = function () {
iframe.contentWindow.focus();
iframe.contentWindow.print();
// 延遲移除,確保列印對話框已開啟
setTimeout(() => document.body.removeChild(iframe), 1000);
};
}
// 使用
printElement('report-area', { extraCss: '/css/print.css' });
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| CSS @media print | 零依賴、標準、效能最好、SEO 友善、支援 @page 精細控制 | 無法「只列印某區域」需靠隱藏其他區域實現 | 全頁列印、報表、發票、簡單頁面 |
| PrintArea 插件 | API 簡單、自動處理 iframe、支援 extraCss | 依賴 jQuery、維護停滯、iframe 樣式隔離有時不完美 | 舊專案 jQuery 技術棧、快速加入局部列印 |
| 原生 iframe 手寫 | 零依賴、完全可控、可注入任意 CSS/JS | 需自行處理樣式複製、跨域 iframe 限制、字體載入時序 | 現代專案、需高度客製化列印輸出 |
| html2canvas + jsPDF | 像素級截圖生成 PDF、跨瀏覽器像素一致 | 大量 DOM 效能差、字體/陰影/Canvas 尺寸限制、文字不可選 | 證書生成、複雜圖表導出 PDF、需離線存檔 |
// 列印前從 API 獲取最新資料渲染,再列印
async function printLatestReport() {
showLoading();
const data = await fetch('/api/report/latest').then(r => r.json());
renderReport(data); // 更新 DOM
await waitForFontsAndImages(); // 確保字體/圖片載入完成
window.print();
hideLoading();
}
function waitForFontsAndImages() {
return Promise.all([
document.fonts.ready,
...Array.from(document.images).filter(img => !img.complete)
.map(img => new Promise(r => { img.onload = img.onerror = r; }))
]);
}
onload 後)、CSS 路徑是否為絕對路徑、@media print 是否生效。table { page-break-inside: avoid; }、thead { display: table-header-group; } 重複表頭。border 模擬。@page { @bottom-center { content: counter(page); } } (支援度有限),或用 html2pdf.js 產生 PDF 後列印。根據專案技術棧與需求複雜度選擇方案,CSS @media print 為首選,局部列印次之,複雜報表導出 PDF 再列印最專業。