html2pdf部署到服务器后生成PDF时CSS样式不加载问题求助
跨域配置问题
html2pdf底层依赖html2canvas渲染DOM,仅能加载符合同源策略的静态资源,本地调试时所有资源都在localhost域名下不存在跨域问题,部署后如果CSS、字体、图片等静态资源和业务域名不一致、或者服务器没有配置静态资源的CORS规则,资源会被浏览器跨域策略拦截导致样式丢失。
解决方案:给静态资源的响应头添加Access-Control-Allow-Origin字段,允许业务域名访问,同时在html2canvas配置中开启跨域加载开关。样式作用域问题
如果使用Vue/React等带样式隔离能力的框架,scoped、CSS Module等配置会让样式仅作用于当前组件内部节点,html2pdf抽取DOM节点生成PDF时,节点脱离了原组件的样式上下文,就会丢失样式。
解决方案:将PDF相关的样式改为全局样式,或是将样式直接内联到待渲染节点、或是手动将需要的CSS写入<style>标签插入到待渲染的configuration-area-c节点内部。静态资源路径问题
本地开发环境的资源路径和服务器部署后的路径不一致,相对路径的CSS、字体等资源部署后会出现404,导致样式无法加载。
解决方案:将所有PDF渲染依赖的静态资源改为绝对路径,或是打包时根据部署环境配置正确的publicPath。资源加载时序问题
服务器网络环境比本地差,点击生成按钮时CSS、字体等资源还未加载完成就触发了渲染逻辑,也会导致样式丢失。
解决方案:生成PDF前增加适当的延迟,或是监听所有依赖资源加载完成后再触发生成逻辑,如果使用了自定义字体,可以用工具监听字体加载完成后再执行生成操作。
修改后的参考代码:
window.onload = function () { document.getElementById("generatePdf").addEventListener("click", () => { const cvitae = document.getElementById("configuration-area-c"); // 手动插入样式到待渲染节点内部,解决样式作用域问题 const pdfStyle = document.createElement('style') pdfStyle.textContent = ` /* 此处写入生成PDF需要用到的所有CSS规则 */ ` cvitae.appendChild(pdfStyle) var opt = { filename: "morsewatchment-configurator.pdf", image: { type: "jpeg", quality: 0.98 }, html2canvas: { scale: 2, useCORS: true, // 开启跨域资源加载 allowTaint: false // 禁止跨域资源污染画布 }, jsPDF: { unit: "in", format: [12, 6], orientation: "portrait" }, }; html2pdf().from(cvitae).set(opt).save(); }); };
内容的提问来源于stack exchange,提问作者Salman Akbar

