Javascript 將html轉成pdf,下載,支持多頁哦（html2canvas 和 jsPDF）

時間 2019-11-06

標籤 javascript html 轉成 pdf 下載支持多頁 html2canvas canvas jspdf 欄目 JavaScript 简体版

原文原文鏈接

最近碰到個需求，須要把當前頁面生成pdf，並下載。弄了幾天，本身整理整理，記錄下來，我以爲應該會有人須要：）javascript

項目源碼地址：https://github.com/linwalker/...css

html2canvas

簡介

咱們能夠直接在瀏覽器端使用html2canvas,對整個或局部頁面進行‘截圖’。但這並非真的截圖，而是經過遍歷頁面DOM結構，收集全部元素信息及相應樣式，渲染出canvas image。html

因爲html2canvas只能將它能處理的生成canvas image，所以渲染出來的結果並非100%與原來一致。但它不須要服務器參與，整個圖片都由客戶端瀏覽器生成，使用很方便。java

使用

使用的API也很簡潔，下面代碼能夠將某個元素渲染成canvas：git

html2canvas(element, {
    onrendered: function(canvas) {
        // canvas is the final rendered <canvas> element
    }
});

經過onrendered方法，能夠將生成的canvas進行回調，好比插入到頁面中：github

html2canvas(element, {
    onrendered: function(canvas) {
       document.body.appendChild(canvas);
    }
});

作個小例子代碼以下，在線展現連接demo1canvas

<html>
  <head>
    <title>html2canvas example</title>
    <style type="text/css">...</style>
  </head>
  <body>
    <header>
      <nav>
        <ul>
          <li>one</li>
          ...
        </ul>
      </nav>
    </header>
    <section>
      <aside>
        <h3>it is a title</h3>
        <a href="">Stone Giant</a>
        ...
     </aside>
      <article>
        <img src="./Stone.png">
        <h2>Stone Giant</h2>
        <p>Coming ... </p>
        <p>以一團石頭...</p>
      </article>
    </section>
    <footer>write by linwalker @2017</footer>
    <script type="text/javascript" src="./html2canvas.js"></script>
    <script type="text/javascript">
        html2canvas(document.body, {
          onrendered:function(canvas) {
            document.body.appendChild(canvas)
          }
        })
    </script>
  </body>
</html>

這個例子將頁面body中的元素渲染成canvas，並插入到body中瀏覽器

jsPDF

jsPDF庫能夠用於瀏覽器端生成PDF。服務器

文字生成PDF

使用方法以下：app

// 默認a4大小，豎直方向，mm單位的PDF
var doc = new jsPDF();

// 添加文本‘Download PDF’
doc.text('Download PDF!', 10, 10);
doc.save('a4.pdf');

在線演示demo2

圖片生成PDF

使用方法以下：

// 三個參數，第一個方向，第二個單位，第三個尺寸格式
var doc = new jsPDF('landscape','pt',[205, 115])

// 將圖片轉化爲dataUrl
var imageData = ‘data:image/png;base64,iVBORw0KGgo...’;

doc.addImage(imageData, 'PNG', 0, 0, 205, 115);
doc.save('a4.pdf');

在線演示demo3

文字與圖片生成PDF

// 三個參數，第一個方向，第二個尺寸，第三個尺寸格式
var doc = new jsPDF('landscape','pt',[205, 155])

// 將圖片轉化爲dataUrl
var imageData = ‘data:image/png;base64,iVBORw0KGgo...’;

//設置字體大小
doc.setFontSize(20);

//10,20這兩參數控制文字距離左邊，與上邊的距離
doc.text('Stone', 10, 20);

// 0, 40, 控制文字距離左邊，與上邊的距離
doc.addImage(imageData, 'PNG', 0, 40, 205, 115);
doc.save('a4.pdf')

在線演示demo4

生成pdf須要把轉化的元素添加到jsPDF實例中，也有添加html的功能，但某些元素沒法生成在pdf中，所以能夠使用html2canvas + jsPDF的方式將頁面轉成pdf。經過html2canvas將遍歷頁面元素，並渲染生成canvas，而後將canvas圖片格式添加到jsPDF實例，生成pdf。

html2canvas + jsPDF

單頁

將demo1的例子修改下：

<script type="text/javascript" src="./js/jsPdf.debug.js"></script>
<script type="text/javascript">
      var downPdf = document.getElementById("renderPdf");
      downPdf.onclick = function() {
          html2canvas(document.body, {
              onrendered:function(canvas) {

                  //返回圖片dataURL，參數：圖片格式和清晰度(0-1)
                  var pageData = canvas.toDataURL('image/jpeg', 1.0);

                  //方向默認豎直，尺寸ponits，格式a4[595.28,841.89]
                  var pdf = new jsPDF('', 'pt', 'a4');

                  //addImage後兩個參數控制添加圖片的尺寸，此處將頁面高度按照a4紙寬高比列進行壓縮
                  pdf.addImage(pageData, 'JPEG', 0, 0, 595.28, 592.28/canvas.width * canvas.height );

                  pdf.save('stone.pdf');

              }
          })
      }
</script>

在線演示demo5

若是頁面內容根據a4比例轉化後高度超過a4紙高度呢，生成的pdf會怎麼樣？會分頁嗎？

你能夠試試，驗證一下本身的想法: demo6

jsPDF提供了一個頗有用的API，addPage()，咱們能夠經過pdf.addPage()，來添加一頁pdf，而後經過pdf.addImage(...)，將圖片賦予這頁pdf來顯示。

那麼咱們如何肯定哪裏分頁？

這個問題好回答，咱們能夠設置一個pageHeight，超過這個高度的內容放入下一頁pdf。

來捋一下思路，將html頁面內容生成canvas圖片，經過addImage將第一頁圖片添加到pdf中，超過一頁內容，經過addPage()添加pdf頁數,而後再經過addImage將下一頁圖片添加到pdf中。

嗯～，很好！巴特，難道沒有發現問題嗎？

這個方法實現的前提是 — — 咱們能根據pageHeight先將整頁內容生成的canvas圖片分割成對應的小圖片，而後一個蘿蔔一個坑，一頁一頁addImage進去。

What? 想想咱們的canvas是腫麼來的，不用拉上去，直接看下面：

html2canvas(document.body, {
    onrendered:function(canvas) {
     //it is here we handle the canvas
    }
})

這裏的body就是要生成canvas的元素對象，一個元素生成一個canvas；那麼咱們須要一頁一頁的canvas，也就是說。。。

你以爲可能嗎？我以爲不太現實，按這思路要獲取頁面上不一樣位置的DOM元素，而後經過htnl2canvas(element,option)來處理，先不說能不能恰好在每一個pageHeight的位置恰好找到一個DOM元素，就算找到了，這樣作累不累。

累的話
：）能夠看看下面這種方法

多頁

我提供的思路是咱們只生成一個canvas，對就一個，轉化元素就是你要轉成pdf內容的母元素，在這篇demo裏就是body了；其餘不變，也是超過一頁內容就addPage，而後addImage,只不過這裏添加的是同一個canvas。

固然這樣作只會出現多頁重複的pdf，那到底怎麼實現正確分頁顯示。其實主要利用了jsPDF的兩點：

- 超過jsPDF實例格式尺寸的內容不顯示
（var pdf = new jsPDF('', 'pt', 'a4'); demo中就是a4紙的尺寸）
- addImage有兩個參數能夠控制圖片在pdf中的位置

雖然每一頁pdf上顯示的圖片是相同的，但咱們經過調整圖片的位置，產生了分頁的錯覺。以第二頁爲例，將豎直方向上的偏移設置爲-841.89即一張a4紙的高度，又由於超過a4紙高度範圍的圖片不顯示，因此第二頁顯示了圖片豎直方向上[841.89,1682.78]範圍內的內容，這就獲得了分頁的效果，以此類推。

仍是看代碼吧：

html2canvas(document.body, {
  onrendered:function(canvas) {

      var contentWidth = canvas.width;
      var contentHeight = canvas.height;

      //一頁pdf顯示html頁面生成的canvas高度;
      var pageHeight = contentWidth / 592.28 * 841.89;
      //未生成pdf的html頁面高度
      var leftHeight = contentHeight;
      //頁面偏移
      var position = 0;
      //a4紙的尺寸[595.28,841.89]，html頁面生成的canvas在pdf中圖片的寬高
      var imgWidth = 595.28;
      var imgHeight = 592.28/contentWidth * contentHeight;

      var pageData = canvas.toDataURL('image/jpeg', 1.0);

      var pdf = new jsPDF('', 'pt', 'a4');

      //有兩個高度須要區分，一個是html頁面的實際高度，和生成pdf的頁面高度(841.89)
      //當內容未超過pdf一頁顯示的範圍，無需分頁
      if (leftHeight < pageHeight) {
      pdf.addImage(pageData, 'JPEG', 0, 0, imgWidth, imgHeight );
      } else {
          while(leftHeight > 0) {
              pdf.addImage(pageData, 'JPEG', 0, position, imgWidth, imgHeight)
              leftHeight -= pageHeight;
              position -= 841.89;
              //避免添加空白頁
              if(leftHeight > 0) {
                pdf.addPage();
              }
          }
      }

      pdf.save('content.pdf');
  }
})

在線演示demo7

兩邊留邊距

修改imgWidth，而且在addImage時x方向參數設置你要的邊距，具體代碼以下

var imgWidth = 555.28;
var imgHeight = 555.28/contentWidth * contentHeight;
...
pdf.addImage(pageData, 'JPEG', 20, 0, imgWidth, imgHeight );
...
pdf.addImage(pageData, 'JPEG', 20, position, imgWidth, imgHeight);

在線演示demo8

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。