三步给 Vue 项目加上图片预览:vue-preview 快速上手教程
发布时间:2026/8/22 18:30:45 作者:尧图编辑部 阅读量:1,286

三步给 Vue 项目加上图片预览vue-preview 快速上手教程【免费下载链接】vue-previewA Vue Integrated PhotoSwipe Image Preview Plugin项目地址: https://gitcode.com/gh_mirrors/vu/vue-previewvue-preview 是一个 Vue 图片预览插件把 PhotoSwipe 封装成了vue-preview组件一行标签就能让页面上的缩略图点开进入全屏沉浸模式支持滑动换图和手势缩放。这篇文章带你把它跑起来。它是什么、适合谁用简单说它解决的是点缩略图看大图这件事。商品列表、相册、文章插图这类多图场景最适用手机端和桌面端都能用。技术上一句话带过基于 Vue 2 PhotoSwipe 实现移动端手势开箱即用。动手前环境准备 依赖用途Node.js运行构建环境npm安装依赖用 yarn 的话换一下命令即可另外注意插件要求 Vue 2.5 及以上Vue 3 项目不适用。三步跑起来 1. 装npm i vue-preview -S2. 注册在main.js里全局注册import Vue from vue import VuePreview from vue-preview Vue.use(VuePreview)不想用默认外观可以在注册时传参数比如tapToClose: true点空白处关闭、captionEl: false隐藏说明文字参数细节看 README.md。3. 用模板里放一个组件把图片数据数组传给slidesvue-preview :slidesslides/vue-previewdata () { return { slides: [ { src: 大图地址, msrc: 缩略图地址, alt: 替换文本, title: 图片说明, w: 600, h: 400 } ] } }每张图至少要有src大图和msrc缩略图w、h填真实宽高。跑完之后 刷新页面点任意缩略图全屏黑底弹出大图手指左右滑换图、双指缩放顶部显示当前是第几张再点区域外或按关闭按钮退出。看到这些就说明装好了。新手容易卡两个地方。一是全屏点不出来多半是数据里msrc或宽高漏了组件靠这两个字段定位缩略图。二是版本问题2.5 以下的 Vue 会不兼容先确认package.json里的 vue 版本。接下来可以看看想进一步定制可以翻翻组件实现 src/preview.vue或者监听close事件在用户关闭预览时顺手做点别的比如统计浏览行为。【免费下载链接】vue-previewA Vue Integrated PhotoSwipe Image Preview Plugin项目地址: https://gitcode.com/gh_mirrors/vu/vue-preview创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考