介绍
viewer.js是一个专门用于图片预览的js库,图片预览效果很好,支持诸如缩放(支持滚轮操作)、旋转、播放、左右翻转、最大化等诸多使用功能,v-viewer则是对其进一步封装,将它带入到Vue组件中,使其方便地在我们的Vue项目中使用,并且支持Vue2和Vue3!
使用
本文以Vue3为例,在Vue3的项目中使用v-viewer
- 首先我们创建一个Vue3的项目
这里我们使用vite初始化我们的项目,用其内置模板创建(有关vite的相关知识,可以查看相关文档),这里我们包管理工具使用yarn
yarn create @vitejs/app my-vue-app --template vue//安装相关依赖包(可以省略,下面安装v-viewer的时候,也会自动安装)yarn
创建完成后,我们简单做一个处理,删掉components中的HelloWorld组件,重新建一个文件,叫ImageViewer.vue,同时我们也要改造一个App.vue,分别如下:
<template> <div></div></template><script lang="ts">import { defineComponent } from "vue";export default defineComponent({ name: "ImageViewer", setup() { return {}; },});</script>
<template> <ImageViewer></ImageViewer></template><script lang="ts">import { defineComponent } from "vue";import ImageViewer from "./components/ImageViewer.vue";export default defineComponent({ name: "App", components: { ImageViewer }, setup() { return {}; },});</script>
- 安装v-viewer
同样的,这里我们依旧使用yarn进行安装v-viewer
yarn add v-viewer@next
然后启动一下项目,检查是否报错
yarn dev
在没问题后我们继续,改造一下main.js
import { createApp } from "vue";import App from "./App.vue";import "viewerjs/dist/viewer.css";import VueViewer from "v-viewer";const app = createApp(App);app.use(VueViewer);app.mount("#app");
- 将准备好的图片放在assets文件夹下用于测试
然后直接上代码,将ImageViewer代码替换如下
<template> <div class="wrap"> <!-- 指定的方式使用 --> <div class="images" v-viewer> <img v-for="src in images" :key="src" :src="src" /> </div> <!-- 组件的方式使用 --> <viewer :images="images"> <img v-for="src in images" :key="src" :src="src" /> </viewer> <!--外部触发 --> <button type="button" @click="show">调用API</button> </div></template><script lang="ts">import { defineComponent } from "vue";import u1 from "../assets/1.jpg";import u2 from "../assets/2.jpg";import u3 from "../assets/3.jpg";import u4 from "../assets/4.jpg";export default defineComponent({ data() { return { images: [u1, u2, u3, u4], }; }, methods: { show() { this.$viewerApi({ images: this.images, }); }, },});</script><style scoped>img { height: 200px;}</style>
总结
v-viewer是一个非常实用的第三方组件,非常简单的就能实现在Web项目中的图片预览功能,而且支持很多框架,笔者认为它是值得推荐使用的,在本文中只是对其进行简单的介绍和基本使用,还有一些其它配置和用法(比如在固定容器内进行预览,都是可以做到的),希望对你有所帮助