VUE实现HTML页面局部内容的打印（print.js），出现多打印一个空白页的问题

最近这段时间，用VUE写东西，有个打印功能。

百度了一下，铺天盖地的VUE打印的两种实现方法。

很感激这些千篇一律的帖子，虽然不知道他们是否真的用过，还是只是复制粘贴。

至少这些帖子告诉我，是有两个可以选择的，并且多看几篇帖子，总算把这两个打印方法，都试了一遍。

下面简单总结一下：

先说结论：建议使用第二种方法，下载print.js到本地，然后放到项目中导入。原因后边说。

-----------------------------------------------------------------2023年4月补充

因为我这边碰到的问题已经解决，因此喜欢使用哪种方法，就根据个人喜好了。因为两种方法都很好用，效果都不错，当然，我个人相对的依然喜欢第二种，源码就在自己项目中完全可控。

 

现在的需求都挺全套的，有了打印，就有可能还需要生成PDF文件下载，有需求可以查看《VUE框架中实现HTML页面（局部）内容转PDF下载》，希望可以解决问题。

-----------------------------------------------------------------2023年4月补充结束

 

一、使用vue-print-nb方法

具体的使用这里就不详细说明了，因为网上真的太多太多了。千篇一律的。

在本地直接npm安装一下就好。按照步骤一点一点来。

然后在自己项目的配置文件里import进来就可以了。

使用就更简单了。选好区域直接调用即可。

打印效果超出预期的好。感谢这个插件的作者！

-----------------------------------------------------------------2023年4月补充

此插件的我提到的类似跨域的BUG，作者在我反馈问题（描述了现象，并说了我的修改建议）不久就给了我回复，已经解决，2019年9月之后测试，当时已经没有问题，但因为公司项目已经上线使用，就没有再换回来，一直使用print.js打印了。

-----------------------------------------------------------------2023年4月补充结束

 

二、使用print.js方法（js文件源码附在文末，有需要可以直接复制）

这个简单的程度更不用说了。就是一个JS下载下来，直接放到项目中（libs目录）

然后同样import导入，并use就可以使用了。

使用方法同样简单，只是写法上看着比第一种感觉上low那么一丢丢，但是真的是超级的简单好用哦。

同时，效果上和第一个基本上一模一样。

 

使用说完了，说说问题吧。

对比：

1、安装和使用

方法一，需要npm安装，说简单也简单，说复杂也复杂。并且所有项目参与者都要安装，否则会报错。

方法二，不需要做什么，只要有一个搞到项目中，其他人版本库中拉代码即可。维护简单方便。

2、调试和维护

方法一，源码相对属于不直接公开的，想看需要到node_modules目录去找，修改日后维护成本稍微高点。

方法二，源码就一个print.js文件，在项目目录中，随时都可以看到，随时可以修改调试，简单方便。并且代码还少哦。

3、使用时的BUG

方法一，存在跨域的BUG，就是link里边的样式路径必须是相对路径或者与站点同域，否则会垮掉。（这个问题在当时反馈给了作者，并提供了解决方案，作者2019年9月应该已经修复）

方法二，目前没有发现使用上的BUG。

 

最后，应用中碰到的问题

最开始使用的是方法一，看着高端。哈哈……但是被坑惨了，因为本地调试和测试环境都没问题。所以一直也就没有发现BUG。直到上线后，再测试才发现问题。因为生产环境CSS是走CDN的，域名不一致了，导致JS报错。打印功能垮掉。

最终临时下掉打印功能，还要向业务部门解释。毕竟答应没做到么。

接下来，解决问题。通过查看源码，不断调试验证，最终发现，就是类似跨域的问题，导致读取link里边的文件失败。报错后终止了JS的执行。当然，BUG原因也找到了，改是能改，但是比较麻烦，毕竟源码不在项目中。

 

然后，尝试使用print.js来实现打印，先确认一下，至少不会有方法一的BUG，然后也做了各测试，确实没有方法一的问题。所以最终我们现在使用这个。但是，因为还没有正式使用，也没有发现问题。

等以后用久了，再看看。不过，源码在项目中，修改多少也方便点儿。

 

还有个莫名其妙的问题

打印预览时，发现多出一个空白页，打印时也会真的打印一个空白页出来。

经过各种折腾，真没发现原因，网上搜索了一下，真心解决办法很少，有一个说的不明不白，有一个说的是body的默认margin的默认值问题。

但是可惜，我这边都不是，所以，在没有办法下，只能自己一点点的调试。什么情况下会有东西超出页面。

不知道最终原因（原理）（我不是专业前端），但是解决了，就是高度100%的问题。页面打印部分有标签高度设置了100%，但是视觉上没有超出，打印时，莫名的就影响了，多出一个空白页。

把这个高度100%删除，就没有空白页了。

所以，出现空白页，注意两点：

1、body的margin属性改成0；

2、找到height属性为100%的尝试修改成其他值或者删除该属性。

当然，如果还有其他问题，大家可以留言讨论，让更多碰到同样问题的朋友，可以在这里找到合适的答案。

 

附上print.js的源码，有需要的直接复制到本地保存即可

print.js源码：

/**
 * 打印类
 * @param {*} dom 打印节点（可以是对象也可以是字符串，会自动识别处理）
 * @param {*} options 打印参数，例如指定某些地方不打印
 * @param {*} debug 打印调试。
 * 说明：
 * debug参数的详细说明
 * 因为很多打印都是局部打印，这样就导致页面代码局部取出后，在新的页面中样式有异常，需要针对打印进行单独设置样式，传入此值，可以像浏览器访问一样调试打印部分样式
 * 传入一组样式的字符串，控制在要打印部分在页面中的显示效果
 * 例如：'width:100%;height:1000px;top:-10px;left:-10px;'
 */
const Print = function (dom, options, debug) {
  if (!(this instanceof Print)) return new Print(dom, options, debug);

  this.options = this.extend({
    'noPrint': '.no-print'
  }, options);

  this.debug = debug;// 是否调试打印，参数是针对打印页面的样式控制，便于显示打印的页面调试

  if ((typeof dom) === "string") {
    this.dom = document.querySelector(dom);
  } else {
    this.isDOM(dom)
    this.dom = this.isDOM(dom) ? dom : dom.$el;
  }

  this.init();
};

Print.prototype = {
  init: function () {
    var content = this.getStyle() + this.getHtml();
    this.writeIframe(content);
  },
  extend: function (obj, obj2) {
    for (var k in obj2) {
      obj[k] = obj2[k];
    }
    return obj;
  },

  getStyle: function () {
    var str = "",
      styles = document.querySelectorAll('style,link');
    for (var i = 0; i < styles.length; i++) {
      str += styles[i].outerHTML;
    }
    str += "<style>" + (this.options.noPrint ? this.options.noPrint : '.no-print') + "{display:none;}</style>";

    return str;
  },

  getHtml: function () {
    var inputs = document.querySelectorAll('input');
    var textareas = document.querySelectorAll('textarea');
    var selects = document.querySelectorAll('select');

    for (var k = 0; k < inputs.length; k++) {
      if (inputs[k].type == "checkbox" || inputs[k].type == "radio") {
        if (inputs[k].checked == true) {
          inputs[k].setAttribute('checked', "checked")
        } else {
          inputs[k].removeAttribute('checked')
        }
      } else if (inputs[k].type == "text") {
        inputs[k].setAttribute('value', inputs[k].value)
      } else {
        inputs[k].setAttribute('value', inputs[k].value)
      }
    }

    for (var k2 = 0; k2 < textareas.length; k2++) {
      if (textareas[k2].type == 'textarea') {
        textareas[k2].innerHTML = textareas[k2].value
      }
    }

    for (var k3 = 0; k3 < selects.length; k3++) {
      if (selects[k3].type == 'select-one') {
        var child = selects[k3].children;
        for (var i in child) {
          if (child[i].tagName == 'OPTION') {
            if (child[i].selected == true) {
              child[i].setAttribute('selected', "selected")
            } else {
              child[i].removeAttribute('selected')
            }
          }
        }
      }
    }

    return this.dom.outerHTML;
  },

  writeIframe: function (content) {
    var w, doc, iframe = document.createElement('iframe'),
      f = document.body.appendChild(iframe);
    iframe.id = "myIframe";
    if (this.debug) {
      // 调试打印样式时使用，相关样式属性，根据需要自行修改，可以通过debug参数传入
      iframe.setAttribute('style', 'position:absolute;z-index:999999;top:0;left:0;border:0;overflow-x:auto;overflow-y:auto;' + this.debug);
    } else {
      // iframe.style = "position:absolute;width:0;height:0;top:-10px;left:-10px;";
      iframe.setAttribute('style', 'position:absolute;width:0;height:0;top:-10px;left:-10px;');
    }
    w = f.contentWindow || f.contentDocument;
    doc = f.contentDocument || f.contentWindow.document;
    doc.open();
    doc.write(content);
    doc.close();
    var _this = this;
    if (!this.debug) {
      // 调试打印时，以下代码不执行
      iframe.onload = function(){
        _this.toPrint(w);
        setTimeout(function () {
          document.body.removeChild(iframe)
        }, 100)
      }
    }
  },

  toPrint: function (frameWindow) {
    try {
      setTimeout(function () {
        frameWindow.focus();
        try {
          if (!frameWindow.document.execCommand('print', false, null)) {
            frameWindow.print();
          }
        } catch (e) {
          frameWindow.print();
        }
        frameWindow.close();
      }, 10);
    } catch (err) {
      console.log('err', err);
    }
  },
  isDOM: (typeof HTMLElement === 'object') ?
    function (obj) {
      return obj instanceof HTMLElement;
    } :
    function (obj) {
      return obj && typeof obj === 'object' && obj.nodeType === 1 && typeof obj.nodeName === 'string';
    }
};

// 原生JS使用此JS文件实现打印，请删除下边的代码
const MyPlugin = {}
MyPlugin.install = function (Vue, options) {
  // 4. 添加实例方法
  Vue.prototype.$print = Print
}
export default MyPlugin

 

以上的JS大致的使用方法：

1、VUE中

使用前先导入（一般放在项目统一导入文件的文件中，默认是_main.js）

import Print from '../libs/js/print.js';

然后再

Vue.use(Print);

然后

this.$print(this.$refs.节点);

节点名：就是要打印内容部分

 

2、普通的原生JS

普通的原生JS实现打印，直接src导入js文件，然后直接调用Print(要打印的内容)即可。

（这个导入的print.js文件，要删除最后7行代码）

这样，就会打印指定标签里的内容了，页面其他内容不会打印。当然如果在指定标签内还有内容不想打印的内容，需要添加no-print样式

 

附上HTML实例源码（仅供参考）：

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>print.js 测试</title>
<script src="js/print.js"></script>
</head>

<body>
<button onclick="Print(biaoge)"> 打印 </button>
<div id="biaoge">
<table width="500" border="1">
  <tbody>
    <tr>
      <td> 姓名</td>
      <td> 性别</td>
      <td>年龄 </td>
    </tr>
    <tr>
      <td> 张三</td>
      <td> 男</td>
      <td>16 </td>
    </tr>
    <tr>
      <td>李四 </td>
      <td>女 </td>
      <td>18 </td>
    </tr>
  </tbody>
</table>
</div>
</body>
</html>