跳转到内容

配置项

全局配置项

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

TIP

由于在配置项使用方面,vue2和vue3区别不大,所以本章内容不会再单独区分。

js
// main.js
Vue.use(hevueImgPreview, options)

局部配置项

我们把在组件内使用插件时传入的参数叫做局部配置项,同时插件也对大部分配置项提供了默认值。他们的优先级如下

优先级

配置项的优先级为 组件内传入配置 > 全局配置 > 默认值

options

此处会列出所有配置项供您快速查看,如果您对某一项有疑问,也可以参考后面对配置项的具体解释

属性名说明类型默认值详细说明
imgList预览的图片地址array-多图预览
nowImgIndex传入多图时当前图片的下标number0多图预览
thumbnail显示缩略图booleantrue多图预览
controlBar底部控制条配置array[]控制条
closeBtn显示右上角关闭按钮booleantrue-
arrowBtn显示左右切换按钮-
clickMaskCLose点击遮罩层是否关闭图片预览booleantrue-
disabledImgRightClick禁止图片右击事件booleanfalse-
disableTransition禁止过渡效果booleanfalse外观与与过渡
customStyle自定义样式object-外观与与过渡
themeName主题名称string-外观与与过渡
zIndex插件层级number9999-
closeFn插件关闭回调函数Function-关闭事件
changeFn多图切换回调函数Function-图片切换事件
locale语言stringzhCNzhCN: 中文
en: English