DIV CSS 佈局教程網

jQuery 局部列印實戰:用 printArea 鎖定區域並自動分頁
編輯:JQuery特效代碼     

後台系統幾乎都躲不掉「列印報表」這個需求。最常見的窘境是:明明只想印出頁面中的某個區塊,瀏覽器卻把導覽列、篩選條件、按鈕甚至頁尾一起送進印表機。本文以 jQuery 的 printArea 外掛為主軸,先說明如何精準鎖定列印範圍,再進一步處理兩個實務上一定會碰到的難題——內容過長的自動分頁,以及「預覽四頁卻印出五頁」的經典 bug。

一、基本用法:一行語法搞定區域列印

引入外掛後,只要對目標容器呼叫 printArea() 就能把該元素的內容送進列印流程:

$("div#printmain").printArea();

二、用 CSS 切斷多餘內容

單純指定區域,被選取區塊之後的內容仍有可能被一起帶入。這時可以借重列印專用的分頁屬性,強制在指定位置換頁:

<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 結構「之後」。放在標籤之前,往往就是多出一張空白頁的元凶。

最後補充:由於當時案子排期很緊,改過的外掛裡有不少寫死的常數,先求本次列印正確,可讀性難免打了折扣。若有人願意把它整理成更通用的版本,那就再好不過了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved