3 Star 64 Fork 8

贺永胜 / hevue-img-preview

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Hi! This is a small survey. I would like to know if any English speaking users are using this plugin. If so, please provide me with an issue so that I can adapt the plugin internationally. And I will write an English version of the usage document

hevue-img-preview 简介

本组件是一个基于 vue 编写的 vue 图片预览组件,支持 pc 和手机端,支持单图和多图预览,仅传入一个图片地址,即可实现图片预览效果。手机端支持单指拖拽和双指缩放。如果能帮上你,希望可以移步 GitHub ,或者码云 给个小星星,如果有任何使用意见或建议,也欢迎回复或者提交 issue

官方文档

官方使用文档请访问 https://heyongsheng.github.io/#/

安装

使用npm进行安装

npm install hevue-img-preview

在main.js进行全局引入


// vue2.x
import hevueImgPreview from 'hevue-img-preview'
Vue.use(hevueImgPreview)

// vue3.x
import hevueImgPreview from 'hevue-img-preview'
const app = createApp(App)
app.use(hevueImgPreview)
app.mount('#app')

在组件中进行使用

<img :src="url" @click="previewImg(url)">
methods: {
	previewImg (url) {
		this.$hevueImgPreview(url)
	}
}

使用

this.$hevueImgPreview() 方法可以接收一个字符串类型的 url,或者对象类型的配置,具体使用方法如下

  • 接收一个地址字符串this.$hevueImgPreview(url)
this.$hevueImgPreview('https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg') // 线上地址
this.$hevueImgPreview('./img/logo.jpeg') // 本地地址
  • 接收一个对象this.$hevueImgPreview(options)
# 单图预览
this.$hevueImgPreview({
    url: 'https://fuss10.elemecdn.com/8/27/f01c15bb73e1ef3793e64e6b7bbccjpeg.jpeg',
})

# 多图预览
this.$hevueImgPreview({
    multiple: true, // 开启多图预览模式
    nowImgIndex: 1, // 多图预览,默认展示第二张图片
    imgList: ['1.png', '2.png', '3.png'], // 需要预览的多图数组
})

配置项

字段 类型 默认值 备注
url String 预览的图片地址,多图预览时省略
multiple Boolean false 是否多图预览
nowImgIndex Number 0 多图预览时默认显示的图片下标
imgList Array 多图预览时传入的图片数组
keyboard Boolean false 是否开启键盘控制
clickMaskCLose Boolean false 是否可以点击遮罩层关闭
controlBar Boolean true 是否显示控制条及页码
closeBtn Boolean true 是否显示关闭按钮
arrowBtn Boolean true 是否显示左右翻页按钮

全局配置

对于某些配置,例如开启键盘事件,点击遮罩层关闭,我们可能要全局保持统一,但却需要在每一次调用时重复配置,为了解决这个问题,我们提供了全局配置项,您可以在引入插件的时候,将全局配置项作为第二个参数传入即可,以免再每次调用的时候重复配置。

// main.js

// vue2.x
import hevueImgPreview from 'hevueImgPreview'
Vue.use(hevueImgPreview, {
  keyboard: true,
  clickMaskCLose: true
  ...
})

// vue3.x
const app = createApp(App)
app.use(hevueImgPreview, {
  keyboard: true,
  clickMaskCLose: true
  ...
})
app.mount('#app')

如开启键盘控制事件后,相对应功能控制按键如下

按键 功能
w 放大
s 缩小
a 上一张
d 下一张
q 逆时针旋转
e 顺时针旋转
r 图片复位
esc 关闭图片预览

更新日志

6.1.0

支持切换图片及关闭图片回调函数,想起请阅读文档

6.0.0

组件兼容vue3.x

5.0.2

组件支持实例化,调用组件将返回组件实例,支持直接通过实例关闭弹窗

const hevueImgPreviewEl = this.$hevueImgPreview(...)
hevueImgPreviewEl.close()

求职广告

本人四年经验前端,急需前端职位,技术栈vue,element之类的,就是学历不太好,只有成人大专,有没有北京上海的大佬公司招人的,看看能不能给个机会,联系方式在下面

作者注

本人前端小白一枚,工作经验较少,所写东西尽量保证没 bug,但性能界面什么的可能没办法做到最优,如果您有什么使用中的建议或意见,欢迎反馈给我,可以加联系方式,也可以直接回复,或者到GitHub提个issue[建议此方法],如果对您有所帮助,万分期待您能给个赞并且到GitHub给个小星星

GitHub 链接:https://github.com/heyongsheng/hevue-img-preview

码云链接:https://gitee.com/ihope_top/hevue-img-preview

作者 QQ:1378431028

QQ 群:595472617

作者微信:heyongsheng1996

空文件

简介

本组件是一个基于 vue 编写的vue图片预览组件,支持单图和多图预览,仅传入一个图片地址,即可实现图片预览效果,比较适合给文章及页面的所有图片添加预览效果,预览背景色,关闭按钮颜色,控制条的背景也和字体颜色都可自定义,兼容 ie9+,火狐,Safari,谷歌浏览器,支持多图预览。如果能帮上你,希望可以给个小星星,如果有任何使用意见或建议,也欢迎回复或者提交issure 展开 收起
取消

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/ihope_top/hevue-img-preview.git
git@gitee.com:ihope_top/hevue-img-preview.git
ihope_top
hevue-img-preview
hevue-img-preview
master

搜索帮助