後台系統幾乎都躲不掉「列印報表」這個需求。最常見的窘境是:明明只想印出頁面中的某個區塊,瀏覽器卻把導覽列、篩選條件、按鈕甚至頁尾一起送進印表機。本文以 jQuery 的 printArea 外掛為主軸,先說明如何精準鎖定列印範圍,再進一步處理兩個實務上一定會碰到的難題——內容過長的自動分頁,以及「預覽四頁卻印出五頁」的經典 bug。
引入外掛後,只要對目標容器呼叫 printArea() 就能把該元素的內容送進列印流程:
$("div#printmain").printArea();
單純指定區域,被選取區塊之後的內容仍有可能被一起帶入。這時可以借重列印專用的分頁屬性,強制在指定位置換頁:
<div style="page-break-after: always;"></div>
實測中偶爾會出現「CSS 已經寫了分頁,卻還是連續印在同一頁」的狀況,這就輪到外掛參數出場了。
printArea 的設定值以 JSON 物件傳入,原始碼中的預設值如下:
var modes = { iframe : "iframe", popup : "popup" };
var defaults = {
mode : modes.iframe,
popHt : 800,
popWd : 800,
popX : 200,
popY : 200,
popTitle : '',
popClose : false,
twoDiv : '', // 自行擴充的屬性
pageTitle: '' // 自行擴充的屬性
};
其中 modes 提供兩種輸出模式:iframe 為預設值,直接在隱藏框架中組裝列印畫面;popup 則會另開新視窗,效果等同於「列印預覽」。
popClose 為布林值,預設 false,也就是列印結束後不關閉預覽視窗;若希望印完自動收掉視窗,可寫成:
$("div#printmain").printArea({ mode: "popup", popClose: true });
twoDiv:需要列印的第二個區塊,它會落在第二頁之後。這個區塊通常很長,且表格每一列高矮不一,有些列本身就跨了好幾行高度,若不做處理,一列很可能被硬生生攷成兩張紙。
pageTitle:當第二個區塊被切成多頁時,每一頁的表頭都要一模一樣,這個參數就是用來存放共用表頭的對應元素。
兩者都指向頁面中預先隱藏好的 DOM 節點,例如:
<div id="pageTitle" style="display: none;">
掌握流程之後,客製化才有依據。核心的寫入與呼叫只有幾行:
writeDoc.open(); writeDoc.write(html); // 開啟視窗並寫入 HTML writeDoc.close(); printWindow.focus(); printWindow.print();
而 html 字串則是由三個方法組裝而成:
html += docType() + "<html>" + getHead() + getBody(thisPage) + "</html>";
docType、getHead、getBody 都是外掛內建的函式,本次未做更動。
要讓一個長區塊「切成多頁、且任何一列都不跨頁」,關鍵其實在於自己動手組 html 的那一段:
先把區塊內的所有列取出來,逐列累加高度,再不放公共表頭一起計算;一旦總高度達到一頁的門檻,就強制換頁。這裡有個容易忽略的細節:換頁的那個瞬間,最後一列可能正好跨在多頁之間,因此要把它保留下來、挪到下一頁開頭,而不是讓它被切開。
每完成一頁,就在該頁 HTML 結構之後補上 CSS 分頁標記,印表機便會乖乖照頁輸出。另外提醒:預覽畫面裡「一頁」就是「一個完整的 HTML 文件」,每頁都自帶對應的 DTD 與表頭資訊。
如果預覽明明只有四頁,印出來卻變五頁,請優先檢查分頁標記的位置——它必須放在 HTML 結構「之後」。放在標籤之前,往往就是多出一張空白頁的元凶。
最後補充:由於當時案子排期很緊,改過的外掛裡有不少寫死的常數,先求本次列印正確,可讀性難免打了折扣。若有人願意把它整理成更通用的版本,那就再好不過了。