網頁列印是後台系統的常見需求。就我目前知道的,主要有三條路:
其中第一種最簡單直觀,以下重點說明。
首先要引入 jQuery 與外掛本身:
<script language="javascript" src="jquery-1.7.1.min.js"></script> <script language="javascript" src="jquery.jqprint.js"></script>
<div class="my_show"> 這個列印時是顯示的 </div> <div class="my_hidden"> 這個列印時是隱藏的。 </div> <input type="button" id="print"/>
<script type="text/javascript">
$(document).ready(function(){
$("#print").click(function(){
$(".my_show").jqprint();
})
});
</script>
用法就是選取要列印的元素後呼叫 jqprint(),未被選取的部分自然不會出現在列印結果中。
這個外掛也提供一些參數可以設定:
{
debug:false, //如果是 true 則可以顯示 iframe 查看效果(iframe 預設高和寬都很小,可以再源碼中調大),預設是 false
importCSS:true, //true 表示引進原來的頁面的 css,預設是 true。(如果是 true,先會找 $("link[media=print]"),若沒有會去找 $("link") 中的 css 檔)
printContainer:true, //表示如果原來選擇的物件必須被納入列印(注意:設置為 false 可能會打破你的 CSS 規則)。
operaSupport:true //表示如果外掛也必須支援 opera 瀏覽器,在這種情況下,它提供了一個臨時的列印分頁。預設是 true
}
我自己實際用到的主要是 importCSS:原始頁面中的連結會被導入到 iframe,它會先搜尋 media="print" 的樣式表,若沒有則改為載入一般的 CSS 檔。
$('.my_show').jqprint({
importCSS: //CSS 樣式檔
});
jqPrint 的原理是建立一個隱藏的 iframe,把選取元素的 HTML 塞進去再呼叫列印。優點是實作極簡,缺點是它複製的是 DOM 而非重新排版,因此原本的樣式經常跑掉,這是 importCSS 參數存在的原因。此外它已多年未維護,對新版 jQuery 與新瀏覽器的相容性沒有保證。
PrintArea 思路類似但更完整,會複製頁面上指定的區塊到彈出視窗或 iframe 中,並處理樣式繼承與列印後的資源清理,適合需要保留較多樣式的報表頁面。
CSS 控制列印樣式是最推薦、也最應該優先考慮的方案。做法是在樣式表中加上 @media print 區塊,明確指定列印時哪些元素隱藏、哪些顯示、間距與色彩如何處理:
@media print {
nav, header, footer, .no-print { display: none; }
body { font-size: 12pt; color: #000; }
a[href]:after { content: " (" attr(href) ")"; }
@page { margin: 2cm; }
}
它的優點很明顯:不需要任何外掛、不依賴 JS(使用者停用 JavaScript 也能列印)、列印的版面完全可控,而且 @page 還能設定紙張大小與邊界。若只想列印頁面的某個區塊,可以用 body * { visibility: hidden } #target, #target * { visibility: visible } 這種技巧,或更乾脆地開一個專門的列印頁面。
我的建議是:能用 CSS 解決就用 CSS,實在需要動態決定列印內容時再考慮外掛,並務必在目標瀏覽器上實際預覽列印結果——不同瀏覽器的列印引擎差異比畫面渲染大得多。