# Imageviewer 图片预览
# 使用指南
图片预览组件,可缩放拖动切换图片
# 代码演示
# 与thinking-ui 2.0版组件的区别以及迁移
按照新的图片预览组件规范修改相关样式
若要做迁移请参考
- 弃用的props:
showArrow
showClose
- 弃用的slot:
title
# API
# 常规使用
<h3-image-viewer :images="list" :index="current" v-model="visible" />
# Prop
属性 | 描述 | 类型 | 默认值 |
---|---|---|---|
visible | 是否显示,v-model 绑定值 | Boolean | false |
images | 展示的图片数组 | Array | [] |
index | 打开图片索引(第一张下标为 0) | Number | null |
maskClosable | 开启点击图片及引导之外遮罩层就会关闭 | Boolean | false |
imageClosable | 在maskCloseable为true时,点击图片是否也可以关闭 | Boolean | false |
safeAreaInsetTop | 上方的安全高度 | String|Number | 0 |
zoom | 支持双指缩放,单指双击放大还原 | Boolean | true |
maxZoom | 默认支持最大缩放倍数 | Number | 2 |
minZoom | 支持的最小倍数,缩放小于最小值减 0.1 默认关闭 | Number | 0.6 |
move | 是否可以移动 | Boolean | true |
getRenderContainer | 把组件挂载某个地方,函数请返回节点,字符串默认通过document.querySelector 查找 | Function=> Node / String | document.body |
images
子配置项
属性 | 描述 | 类型 |
---|---|---|
url | 图片地址 | string |
title | 图片描述 | boolean |
let images = [{
url: 'xxx'
title: 'xxx'
}, ...];
也可以是字符串
let images = ['xxx', ...];
# Event
事件名 | 描述 | 参数 |
---|---|---|
toggle | 切换显示时触发,v-model 绑定事件 | value |
show | 显示时回调 | value:true |
hide | 隐藏时回调 | value:false |
slide | 滑动图片切换的回调函数 | index: number |
zoom | 当前放大的倍数 | zoom: number |
menu | 长按图片触发 | image, index, images |
# slot
slot | 描述 | 参数 |
---|---|---|
extra | 底部放额外操作的插槽,如删除、下载等 | - |
# 函数式调用
# 引用
import Vue from 'vue';
import { H3ImageViewer } from '@lateinos/thinking-ui';
Vue.use(H3ImageViewer);
// 显示
this.$imageviewer.show(options:{images:[]}, showCb?:Function, hideCb?:Function, menuCb?:Function, extra?: (item: ImagesItem, h: CreateElement) => VNode);
// 隐藏
this.$imageviewer.hide(hideCb?:Function);
函数 | 描述 | 参数 |
---|---|---|
show | options(浅合并进去) 其中images必填,回调函数 | (options:{images:[]}, showCb?: 显示后回调, hideCb?: 隐藏后回调, menuCb?: 长按图片触发, extra?: 额外按钮插槽) |
hide | 回调函数 | (hideCb?:隐藏后回调) |
← Tag 标签 Calendar 日历 →