vue3插件——vue-web-screen-shot——实现页面截图功能

最近在看前同事发我的

vue3

框架时，发现他们有个功能是要实现页面截图功能。

vue3插件——vue-web-screen-shot——实现页面截图功能

效果图如下：

最近项目遇到的要求是弹出框上传文件，需要用到页面截图，由于使用的是Vue3的框架于是选择用vue-web-screen-shot组件进行操作。(由于插件是Vue3编写的，所以只适用于Vue3的项目，如果是Vue2的项目，截图组件可以使用js-web-screen-shot)

下面介绍实现步骤：

1.操作步骤

1.1在项目中添加

vvue-web-screen-shot

组件

我这边安装的版本是

1.5.2

，安装代码指令如下：

yarn add vue-web-screen-shot

或者

npm install vue-web-screen-shot --save

1.2在项目入口文件导入组件——

main.ts

在

main.ts

文件中导入组件

import screenShort from'vue-web-screen-shot';const createClient =async():Promise<void>=>{const app =createApp(App);
    app.use(screenShort,{enableWebRtc:false});
    app.mount('#app');}

1.3在需要使用的页面使用组件

<a-upload ref="uploadRef" v-model:file-list="issueForm.fileList" action="/api/sys-storage/image/upload":headers="{'Fusion-Auth':getToken()||'',//此处放头部信息}"
:limit="1"
accept="image/png,image/jpeg,image/jpg"
image-preview
list-type="picture-card":show-link="true":on-button-click="handleButtonClick"/>

<screen-short v-if="screenshotStatus" @destroy-component="destroyComponent" @get-image-data="completeCallback"></screen-short>

如果将screen-short组件放在弹出窗内部，则隐藏弹出窗时会连同截屏组件一起隐藏，所以建议放在外部，并给弹出窗单独加一个div，用showScreenShort控制弹出窗显示和隐藏。

参数说明：
如示例代码所示，在template中直接使用screen-short插件，绑定组件需要的事件处理函数即可。
接下来就跟大家讲下组件中每个属性的意义：

screenshotStatus：用于控制组件是否出现在dom中
@destroy-component：用于接收截图组件传递的销毁消息，我们需要在对应的函数中销毁截图组件
@get-image-data：用于接收截图组件传递的框选区的base64图片信息，我们需要为他提供一个函数来接收截图组件传递的消息

可选参数
截图插件有一个可选参数，它接收一个对象，对象每个key的作用如下：

enableWebRtc：是否启用webrtc，值为boolean类型，值为false则使用html2canvas来截图
level：截图容器层级，值为number类型
clickCutFullScreen：单击截全屏启用状态，值为boolean类型，默认为false
hiddenToolIco：需要隐藏的截图工具栏图标，值为{save?:boolean;undo?:boolean;confirm?:boolean}类型，默认为{}。传你需要隐藏的图标名称，将值设为true即可。
enableCORS：html2canvas截图模式下跨域的启用状态，值为boolean类型，默认为false
proxyAddress：html2canvas截图模式下的图片服务器代理地址，值为string类型，默认为undefined

1.4在页面截图后使用获得的64位编码转为图片文件形式进行上传

<script setup lang="ts">const screenshotStatus = ref<boolean>(false);constdestroyComponent=(status:boolean)=>{
    screenshotStatus.value = status;}constcompleteCallback=async(base64data:any)=>{const bytes = window.atob(base64data.split(',')[1]);const buffer =newArrayBuffer(bytes.length);const uint = ew Uint8Array(buffer);for(let j =0;j<bytes.length:j++){
        uint[j]= bytes.charCodeAt(j);}const imageFile =newBlob([buffer],{type:'image/jpeg'});const formData =newFormData();
    formData.append('file',imageFile,`${Data.now()}.jpeg`);const res =awaitfileUpload(formData);if(res.status){
        curPicToken.value = res.data.fileToken;
        issueForm.fileList =[];
        issueForm.fileList.push({url:`/api/sys-storage/download_image?f8s=${res.data.fileToken]`,})}}const handleButtonClick =(event:Event):Promise<FileList>|void=>{
    event.preventDefault();
    screenshotStatus.value =true;}</script>

2.参考链接：

vue-web-screen-shot 前端实现页面截图：https://blog.csdn.net/w1060436872/article/details/129065847

arco.design—上传 Upload：https://arco.design/vue/component/upload