近碰到個需求,需要把當前頁面生成 pdf,并下載。弄了幾天,自己整理整理,記錄下來,我覺得應該會有人需要 :)
項目源碼地址:https://github.com/linwalker/render-html-to-pdf
我們可以直接在瀏覽器端使用html2canvas,對整個或局部頁面進行“截圖”。但這并不是真的截圖,而是通過遍歷頁面DOM結構,收集所有元素信息及相應樣式,渲染出canvas image。
由于html2canvas只能將它能處理的生成canvas image,因此渲染出來的結果并不是100%與原來一致。但它不需要服務器參與,整個圖片都由客戶端瀏覽器生成,使用很方便。
使用
使用的API也很簡潔,下面代碼可以將某個元素渲染成canvas:
html2canvas(element, { onrendered: function(canvas) { // canvas is the final rendered <canvas> element } });
通過onrendered方法,可以將生成的canvas進行回調,比如插入到頁面中:
html2canvas(element, { onrendered: function(canvas) { document.body.appendChild(canvas); } });
做個小例子(demo1)代碼如下:
這個例子將頁面body中的元素渲染成canvas,并插入到body中。
jsPDF庫可以用于瀏覽器端生成PDF。
使用方法如下:
// 默認a4大小,豎直方向,mm單位的PDF var doc=new jsPDF(); // 添加文本‘Download PDF’ doc.text('Download PDF!', 10, 10); doc.save('a4.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')
生成pdf需要把轉化的元素添加到jsPDF實例中,也有添加html的功能,但某些元素無法生成在pdf中,因此可以使用html2canvas + jsPDF的方式將頁面轉成pdf。通過html2canvas將遍歷頁面元素,并渲染生成canvas,然后將canvas圖片格式添加到jsPDF實例,生成pdf。
單頁
將demo1的例子修改下:
如果頁面內容根據a4比例轉化后高度超過a4紙高度呢,生成的pdf會怎么樣?會分頁嗎?
你可以試試,驗證一下自己的想法。
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的兩點:
雖然每一頁pdf上顯示的圖片是相同的,但我們通過調整圖片的位置,產生了分頁的錯覺。以第二頁為例,將豎直方向上的偏移設置為 -841.89即一張a4紙的高度,又因為超過a4紙高度范圍的圖片不顯示,所以第二頁顯示了圖片豎直方向上[841.89,1682.78]范圍內的內容,這就得到了分頁的效果,以此類推。
還是看代碼吧:
修改imgWidth,并且在addImage時x方向參數設置你要的邊距,具體代碼如下:
作者:linwalkerhttps://segmentfault.com/a/1190000009211079
里講一種實現起來比較簡單的html轉pdf下載的實現。
html2canvas jspdf
通過html2canvas,我們可以將指定的一個dom元素,渲染到canvas中,然后從canva中獲得該圖片,并將圖片通過jspdf來生成。
function createPdf (selector,pagesize,direction,title){
var key=pagesize +''+direction;
var settings={
'00' : {
pdf : {orientation : 'portrait',format : 'a4',unit : 'px'},
width : 448,
height : 632.5
},
'01' : {
pdf : {orientation : 'landscape',format : 'a4',unit : 'px'},
width : 632.5,
height : 448
},
'10' : {
pdf : {orientation : 'portrait',format : 'a3',unit : 'px'},
width : 632.5,
height : 894.2
},
'11' : {
pdf : {orientation : 'landscape',format : 'a3',unit : 'px'},
width : 894.2,
height : 632.5
}
};
var set=settings[key];
var doc=new jsPDF(set.pdf);
var arr=[];//根據順序保存
var $arr=$(selector);
function tempCreate(){
if($arr.length==0){//沒有啦
//執行生成
tempPdf();
}else{
var $dom=$arr.splice(0,1);
html2canvas($dom[0]).then(canvas=> {
var dataurl=canvas.toDataURL('image/png');
arr.push(dataurl);
tempCreate();
});
}
}
function tempPdf(){
arr.forEach((item,i)=>{
if(i !==0){
doc.addPage();
}
doc.addImage(item,'png',-1,-1,set.width,set.height);//根據不同的寬高寫入
})
//根據當前的作業名稱
doc.save(title+'.pdf');
}
tempCreate();
}
需要指定容器(依賴jquery),然后指定紙張A4或 A3,以及橫縱向。
//調用
createPdf('.single-page',0,0,'test')
當然,如果是數據量很大的話,就不建議在前臺生成了,最好還是放在后端去做。個人測試過,做A4的圖片生成PDF,當數量大約在100左右的時候,瀏覽器就崩潰了,如果只是幾頁的數據的話,這個方式還是很方便的。
Ps:瀏覽器要是現代瀏覽器哈。
html2canvas : http://html2canvas.hertzen.com/ jspdf :https://github.com/MrRio/jsPDF
坑給你踩完,可行的結果給你探明,讓你的方向明確,存在的小問題自行解決)
前端轉PDF,本質就是把網頁通過canvas轉成圖片,圖片轉成PDF。
坑1:PDF文件占內存很大,本來應該是500kb的pdf,直接給你轉出20M的pdf。
坑2:PDF很模糊,文字重影,各種控制畫質的參數都無法解決。
坑3:PDF中其實就是一張圖片,文字無法復制。
后端轉PDF,本質就是用PHP干HTML的事情。
坑1:PHP去寫html那種苦,只有苦命人能吃,特別是遇到JS圖表等樣式,直接生無可戀。
坑2:PHP去干html的事情無法在瀏覽器上預覽,只有寫一下導出pdf看效果,一套開發下來,導幾百個pdf,這種苦您能吃不?
坑3:還要求你引入字體包等,麻煩死了。
后端調用HTML轉PDF,本質就是PHP是識別HTML,再轉出來。
坑1:大部分HTML不支持,不支持css文件,不支持js等圖表,只能寫行內樣式。
坑2:寫出來的瀏覽器預覽效果和導出來的PDF不一致,試著去調樣式,再導出pdf看效果,一套開發下來,導幾百個pdf,這種苦您能吃不?
1、準備工作:待轉網頁、服務器環境。
(1)、待轉網頁:把你要轉出的網頁樣式,用html、css、js排版出來,不用去在乎兼容性,您能想到的效果都支持。如果您是在網站中彈窗頁面預覽,網頁套在ifram中彈窗即可。
(2)、服務器環境:建議使用傻瓜式維護linux的寶塔,如果您是的linux命令高手也可以不用寶塔。
2、安裝wkhtmltopdf:在服務器上安裝wkhtmltopdf軟件。
安裝軟件過程中可能會出現各種各樣的linux提示報錯,因為報錯多種多樣,我沒辦法給您一一列舉,您根據linux的報錯去自行爬文檔處理,我這里只給一個我探明可行,可用的思路,你順著思路走即可。
A、 打開服務器終端。
B、下載wkhtmltopdf復制運行命令:
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm
C、安裝wkhtmltopdf復制運行命令:
sudo yum localinstall -y wkhtmltox-0.12.5-1.centos7.x86_64.rpm
D、檢測wkhtmltopdf是否安裝成功,復制運行命令:
wkhtmltopdf -V
3、用PHP創建一個超出的API接口
function PDF()
{
$inputFile='https://baidu.com'; //您要轉出的網頁路徑
$outputFile=ROOT_PATH . 'public/uploads/pdf/xxxx.pdf'; //存放PDF的物理路徑
$url='/public/uploads/pdf/xxxx.pdf'; //定義相對路徑
$wkhtmltopdfBinary='/usr/local/bin/wkhtmltopdf --margin-top 5mm --margin-bottom 5mm --margin-left 5mm --margin-right 5mm'; //wkhtmltopdf命令的路
$command=$wkhtmltopdfBinary . ' ' . escapeshellarg($inputFile) . ' ' . escapeshellarg($outputFile); //構建命令
exec($command, $output, $returnCode); //執行命令行
//執行失敗暴露錯誤,用于debug
if ($returnCode !==0) {
$obj['output']=$output;
$obj['returnCode']=$returnCode;
return $obj;
};
//執行成功,如果有數據庫操作,請在下面寫你的數據操作
}
}
4、導出效果
*請認真填寫需求信息,我們會在24小時內與您取得聯系。