vue项目中如何调用浏览器的打印功能

程序员的自我修养.png

前言

关于vue调用浏览器的打印功能、一篇文章就够了!最近工作过程中,产品提了一个需求,想要把项目中的聊天记录打印出来(页面中有很多的元素,聊天记录只是其中的一部分)。一开始觉得功能简单,只要调用浏览器的print()就行,事实证明,调用浏览器的print是打印整个页面的内容,那么就违背了产品定义的需求。做还是不做?不做?研发能力不行。做?脑子瓦特!

最终,经过一系列的调研,查询到了vue-print-nb一款用于vue打印,快捷,方便,简单的组件。

接下来给大家介绍vue如何利用vue-print-nb实现打印功能,并切针对在实现过程中遇到的问题。

一、安装 vue-print-nb

vue-print-nb是npm的依赖包根据vue版本不同需要安装不同的依赖

Vue2.0版本安装方法:

npm install vue-print-nb --save
// 在main.js文件中引入并全局挂载
import Print from 'vue-print-nb'
Vue.use(Print);

Vue3.0版本安装方法:

npm install vue3-print-nb --save
// 引入并全局挂载
import { createApp } from 'vue'
import App from './App.vue'
import print from 'vue3-print-nb'
const app = createApp(App)
app.use(print)
app.mount('#app')

二、v-print API(参数设置)

参数 说明 类型 可选值 默认值
id 局部打印有效,标识符 String - printId
standard 局部打印有效,仅限本地打印 String HTML5/loose/strict HTML5
extraHead 局部打印有效,添加在打印区域的最顶端 String - -
extraCss 局部打印有效,为打印区域提供style样式 String - -
popTitle 局部打印有效,页眉的标题 String - -
openCallback 调用打印工具成功回调函数 Function Vue返回当时被调用的实例 -
closeCallback 关闭打印工具成功的回调函数 Function Vue返回当时被调用的实例 -
beforeOpenCallback 调用打印工具前的回调函数 Function Vue返回当时被调用的实例 -
asyncUrl 通过 'resolve()' 和 Vue 返回 URL Function - -
previewBeforeOpenCallback 启动预览工具前的回调函数 Function Vue返回当时被调用的实例 -
previewOpenCallback 完全打开预览工具后的回调函数 Function Vue返回当时被调用的实例 -
clickMounted 点击打印按钮的回调函数 Function Vue返回当时被调用的实例 -
url 打印指定的 URL。(不允许同时设置ID) string - -
preview 预览工具 Boolean - false
previewTitle 预览工具标题 String - 打印预览
previewPrintBtnLabel 预览工具按钮的名称 String - 打印
zIndex 预览工具的 CSS:z-index String - 20002

三、代码应用

在线演示demo:https://power-kxlee.github.io/vue-print-nb/dist/index.html

使用方法:

打印整个页面

<button v-print>打印</button>

打印部分元素

 <div id="printMe">   
     <div>打印此处</div>
     <div>1111</div>
     <div>2222222</div>
 </div>

 <button v-print="'#printMe'">打印</button>

id必须是唯一的,v-print绑定的就是需要打印的元素

打印网址:

打印指定的URL网址(确保URL是同源策略)

 <button v-print="printObj">打印</button>
export default {
    data() {
        return {
            printObj: {
              url: 'http://localhost:8080/'
              beforeOpenCallback (vue) {
                console.log('打开之前')
              },
              openCallback (vue) {
                console.log('执行了打印')
              },
              closeCallback (vue) {
                console.log('关闭了打印工具')
              }
            }
        };
    }
}

打印异步网址

异步获取网址并且打印

 <button v-print="printObj">打印</button>
export default {
    data() {
        return {
            printObj: {
              asyncUrl (reslove, vue) {
                setTimeout(() => {
                  reslove('http://localhost:8080/')
                }, 2000)
              },
              previewBeforeOpenCallback (vue) {
                console.log('正在加载预览窗口')
              },
              previewOpenCallback (vue) {
                console.log('已经加载完预览窗口')
              },
              beforeOpenCallback (vue) {
                console.log('打开之前')
              },
              openCallback (vue) {
                console.log('执行了打印')
              },
              closeCallback (vue) {
                console.log('关闭了打印工具')
              }
            }
        };
    }
}

通过reslove返回你想要打印的网址

四、可能会遇到的问题

在开发过程中,我们很有可能会遇到写的css样式在打印中失效、是因为浏览器打印样式不能配合scss和less使用,我们只需要吧样式写在style中就可以。

其次在previewBeforeOpenCallback、previewOpenCallback、beforeOpenCallback、openCallback、closeCallback方法中vue参数只是当前被调用的实例、并不能操作demo。

浏览器预览窗口打开之后数据就不会再重新渲染,我们之能在v-print="'#printMe'"之前,将数据渲染完成。

在线演示demo:https://power-kxlee.github.io/vue-print-nb/dist/index.html

结尾

vue-print-nb一款用于vue打印,快捷,方便,简单的组件,需要的小伙伴可以参考在线演示demo。

来源:https://github.com/Power-kxLee/vue-print-nb

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容