v-preview-image

一个基于vue3的图片预览插件，可以缩放图片，移动图片，旋转图片，目前只支持pc端。

因为之前做管理后台时，经常有图片需要预览，使用element的图片预览必须基于它的image组件， 我觉得不够方便，所以模仿它的样式封装了这个图片预览插件,可在任何vue3的pc项目使用。

该预览插件使用非常简单、方便！

如果您使用过程中发现有问题或者可优化的地方都果断提出来！

如果对您有帮助，麻烦给个Star！

github

该版本为vue3版本，vue2版本请查看2.x分支文档

npm安装

1npm install v-preview-image@^3.x -S

在main.js引入

1import vPreviewImage from 'v-preview-image'
2app.use(vPreviewImage)

调用方式

可在模板中直接调用

1<div @click="$preview(current,list,key)"></div>

也可在js中通过实例调用:

1this.$preview(current,list,key)

组合式api中引入方法调用

1import { preview } from 'v-preview-image'
2preview(current,list,key)

参数	说明	类型
current	当前预览的图片索引或者url	String/Number
list	需要预览的图片数组，非必传。如果不传的话，current必须为url，不能为索引。	Array
key	如果list里面的item是图片的url 则不需要，如果是对象的话，需传图片的在对象中的key	String

关闭预览

1import { closePreview } from 'v-preview-image'
2closePreview()

修改默认配置

1// 方式一：引入方法传入配置
2import { setPreviewDefaultOptions } from 'v-preview-image'
3
4setPreviewDefaultOptions({
5  enabledMaskClose: false, // 是否开启点击遮罩关闭(默认为true)
6  enabledEscClose: false, // 是否开启esc按键关闭(默认为true)
7  enabledMouseZoom: false, // 是否开启鼠标滚轮缩放(默认为true)
8  activeColor: 'green' // 预览图中选中图片的背景颜色(默认为rgba(239, 84, 78, 0.7))
9  previewStyle: { width: 'auto',height: 'auto',objectFit: 'cover'}, // 预览图样式
10  showDownloadBtn: false // 显示下载按钮
11})
12
13// 方式二：在app.use时传入配置
14import vPreviewImage from 'v-preview-image'
15app.use(vPreviewImage, { activeColor: '#ff0033' })

示例

1<template>
2  <div class="container">
3    <h1>示例：</h1>
4    <button @click="$preview(0, list)">第一个参数可传入索引,第二个参数传入需要预览的图片数组</button><br /><br />
5    <button @click="$preview(url, list)">第一个参数也可传入url</button><br /><br />
6    <button @click="$preview(url)">也可以只传入url，单张图片预览</button><br /><br />
7    <button @click="$preview(0, list2, 'url')">如果数组的item是对象的话，则第三个参数要指定图片在对象中的key</button><br /><br />
8    <button @click="handleClick">也可通过实例调用</button><br /><br />
9    <button @click="handleClick2">使用setup组合式api时引入方法调用</button><br /><br />
10  </div>
11</template>
12
13<script>
14import { preview } from 'v-preview-image' // 使用setup组合式api时引入方法调用
15export default {
16  data() {
17    return {
18      url: 'https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg',
19      list: [
20        'https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg',
21        'https://fuss10.elemecdn.com/1/8e/aeffeb4de74e2fde4bd74fc7b4486jpeg.jpeg',
22        'https://fuss10.elemecdn.com/2/11/6535bcfb26e4c79b48ddde44f4b6fjpeg.jpeg',
23        'https://fuss10.elemecdn.com/3/28/bbf893f792f03a54408b3b7a7ebf0jpeg.jpeg',
24        'https://fuss10.elemecdn.com/d/e6/c4d93a3805b3ce3f323f7974e6f78jpeg.jpeg',
25        'https://fuss10.elemecdn.com/9/bb/e27858e973f5d7d3904835f46abbdjpeg.jpeg',
26        'https://fuss10.elemecdn.com/0/6f/e35ff375812e6b0020b6b4e8f9583jpeg.jpeg',
27        'https://fuss10.elemecdn.com/1/34/19aa98b1fcb2781c4fba33d850549jpeg.jpeg',
28        'https://fuss10.elemecdn.com/a/3f/3302e58f9a181d2509f3dc0fa68b0jpeg.jpeg'
29      ],
30      list2: [
31        { url: 'https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg' },
32        { url: 'https://fuss10.elemecdn.com/1/8e/aeffeb4de74e2fde4bd74fc7b4486jpeg.jpeg' },
33        { url: 'https://fuss10.elemecdn.com/2/11/6535bcfb26e4c79b48ddde44f4b6fjpeg.jpeg' }
34      ]
35    }
36  },
37  methods: {
38    handleClick() {
39      this.$preview(0, this.list)
40    }
41  },
42  setup(){
43    const handleClick2 = ()=>{
44      let url = 'https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg'
45      // 使用setup组合式api时引入方法调用
46      preview(url)
47    }
48    return {
49      handleClick2
50    }
51  }
52}
53</script>
54
55