DIV CSS 佈局教程網

把 HTML 頁面轉成圖片再寫入 PDF:html2canvas 加 iText 全流程
編輯:關於JavaScript     

需求是「把目前頁面導出成 PDF」。這件事的標準解法分兩段:前端用 html2canvas 把 DOM 截成圖,後端用 iText 把圖片排進 PDF。前端有 jsPDF 可以直接生成,但它對舊版 IE 支援不佳,所以走「圖片 + 後端組版」這條路相容性最好。

前端:html2canvas 截圖並上傳

流程是:截圖 → toDataURL 轉成 base64 → 轉成 Blob 塞進 FormData → 用 XHR 上傳。

 html2canvas(document.body, {
  //截圖對象,此處可配置詳細參數
  onrendered: function(canvas) {
   canvas.id = "mycanvas";

   //產生 base64 圖片數據,指定格式也可不帶參數
   var dataUrl = canvas.toDataURL('image/png');

   var formData = new FormData();   //模擬表單物件
   formData.append("imgData", convertBase64UrlToBlob(dataUrl), "123.png");

   var xhr = new XMLHttpRequest();
   xhr.open("POST", "../bulletin/exportPdf");
   xhr.send(formData);

   xhr.onreadystatechange = function(){
    if (xhr.readyState == 4) {
     if (xhr.status == 200) {
      var back = JSON.parse(xhr.responseText);
      if (back.success == true) {
       alertBox({content: 'Pdf導出成功!', lock: true, drag: false, ok: true});
      } else {
       alertBox({content: 'Pdf導出失敗!', lock: true, drag: false, ok: true});
      }
     }
    }
   };
  }
});

//把 base64 的圖片 url 轉為 Blob
function convertBase64UrlToBlob(urlData){
  //去掉 url 的頭,並轉為 byte
  var bytes = window.atob(urlData.split(',')[1]);

  //處理異常:將 ascii 碼小於 0 的轉為大於 0
  var ab = new ArrayBuffer(bytes.length);
  var ia = new Uint8Array(ab);
  for (var i = 0; i < bytes.length; i++) {
   ia[i] = bytes.charCodeAt(i);
  }
  return new Blob([ab], {type: 'image/png'});
}

相容性與已知限制

支援 Firefox 3.5+、Chrome、Opera、IE10+。不支援 iframe 內容、瀏覽器外掛與 Flash。跨域圖片需要在該伺服器的回應標頭加上:

 access-control-allow-origin: *
access-control-allow-credentials: true

SVG 圖片無法直接支援(社群已有補丁,但穩定性需自行評估)。另外 IE9 不支援 FormData 與 Blob,這種情況下就把 toDataURL 去掉 url 頭之後的字串直接 POST 給後端:

 String base64 = img.split(",")[1];
BASE64Decoder decode = new BASE64Decoder();
byte[] imgByte = decode.decodeBuffer(base64);

後端:用 iText 把圖片排進 PDF

先引入 iText 的 jar 檔。iText 是 SourceForge 上知名的開源專案,用來產生 PDF 的 Java 類庫,速度快、支援許多進階特性。

 @RequestMapping("/exportPdf")
public @ResponseBody void exportPdf(MultipartHttpServletRequest request,
   HttpServletResponse response) throws ServletException, IOException {

  ResultData result = new ResultData();   //自定義結果格式
  String filePath = "c:\\exportPdf2.pdf";
  String imagePath = "c:\\exportImg2.bmp";
  Document document = new Document();

  try {
   Map getMap = request.getFileMap();
   MultipartFile mfile = (MultipartFile) getMap.get("imgData");

   //取得上傳的資料
   InputStream file = mfile.getInputStream();
   byte[] fileByte = FileCopyUtils.copyToByteArray(file);

   //寫成本地圖片檔
   FileImageOutputStream imageOutput = new FileImageOutputStream(new File(imagePath));
   imageOutput.write(fileByte, 0, fileByte.length);
   imageOutput.close();

   PdfWriter.getInstance(document, new FileOutputStream(filePath));
   // document.setPageSize(PageSize.A2);
   document.open();
   document.add(new Paragraph("JUST TEST ..."));

   Image image = Image.getInstance(imagePath);
   float heigth = image.getHeight();
   float width = image.getWidth();

   //按比例縮小圖片,避免超出頁面
   int percent = getPercent2(heigth, width);
   image.setAlignment(Image.MIDDLE);
   image.scalePercent(percent + 3);
   document.add(image);

   document.close();

   result.setSuccess(true);
   operatelogService.addOperateLogInfo(request, "導出成功:成功導出簡報Pdf");
  } catch (DocumentException de) {
   System.err.println(de.getMessage());
  } catch (Exception e) {
   e.printStackTrace();
   result.setSuccess(false);
   result.setErrorMessage(e.toString());
   try {
    operatelogService.addOperateLogError(request, "導出失敗:服務器異常");
   } catch (Exception e1) {
    e1.printStackTrace();
   }
  }
  response.getWriter().print(JSONObject.fromObject(result).toString());
}

private static int getPercent2(float h, float w) {
  int p = 0;
  float p2 = 0.0f;
  p2 = 530 / w * 100;
  p = Math.round(p2);
  return p;
}

踩過的坑與建議

iText 有個惱人的特性:出錯時它不會明確拋錯,而是跳過繼續執行,最後得到一個損壞的 PDF,你完全不知道哪一步失敗。除錯時建議分段檢查——先把圖片檔存下來確認截圖正常,再確認 iText 能單獨把這張圖寫成 PDF,最後才接上網路層。

另外幾點實務考量:截長頁面時 html2canvas 的記憶體用量會隨高度急遽上升,必要時應分段截圖並跨頁排版;產生的 PDF 若需要給使用者下載,別忘了改用 response.setContentType("application/pdf") 直接輸出串流,而不是先落地成實體檔案再提供路徑;檔名與暫存位置也要處理好,避免多人同時導出時互相覆蓋。

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