Vue 中使用圖片查看器 v-viewer

• 插件簡介

基於 viewer.js 插件，用於 Vue 的圖像查看器組件

官網地址：https://mirari.cc/v-viewer/

• 下載安裝

通過 npm 安裝：

npm install v-viewer

GitHub 下載地址：https://github.com/mirari/v-viewer

• UMD 用法

Browser：

<link href="viewerjs/viewer.css" rel="stylesheet">
<script src="vue/vue.js"></script>
<script src="viewerjs/viewer.js"></script>
<script src="viewerjs/v-viewer.js"></script>
<!-- 指令形式 -->
<div class="images" v-viewer>
　　<img src="1.jpg">
　　<img src="2.jpg">
</div>
<!-- 組件形式 -->
<viewer :images="images">
　　<img v-for="src in images" :src="src" :key="src">
</viewer>
<script>
　　Vue.use(VueViewer.default)
</script>

CommonJS：

var VueViewer = require('VueViewer');

AMD：

require(['VueViewer'], function (VueViewer) {});

 

• Vue 指令形式用法

只需要將 v-viewer 指令添加到任意元素即可，該元素下的所有 img 元素都會被 viewer 自動處理。

可以傳入 options 配置項：v-viewer="{inline: true}"

可以先用選擇器查找到目標元素，然后用 el.$viewer 來獲取 viewer 實例。

<template>
　　<div id="app">
　　　　<div class="images" v-viewer="{movable: false}">
　　　　　　<img v-for="src in images" :src="src" :key="src">
　　　　</div>
　　　　<button type="button" @click="show">Show</button>
　　</div>
</template>
<script>
import 'viewerjs/dist/viewer.css'
import Viewer from 'v-viewer'
import Vue from 'vue'
Vue.use(Viewer)
export default {
data() {
　　images: ['1.jpg', '2.jpg']
},
methods: {
　　show () {
　　　　const viewer = this.$el.querySelector('.images').$viewer
　　　　viewer.show()
　　　　}
　　}
}
</script>

 

指令修飾器：static

添加修飾器后台，viewer 的創建只會在元素綁定指令時執行一次。

如果你確定元素內的圖片不會再發生變化，使用它可以避免不必要的重建動作。

<div class="images" v-viewer.static="{inline: true}">
　　<img v-for="src in images" :src="src" :key="src">
</div>

 

• Vue 組件形式用法

你也可以單獨引入全屏組件並局部注冊它。

使用 作用域插槽 來定制你的圖片展示方式。

監聽 inited 事件來獲取 viewer 實例，或者也可以用 this.refs.xxx.$viewer 這種方法。

<template>
　　<div id="app">
　　　　<viewer :options="options" :images="images"
　　　　@inited="inited" class="viewer" ref="viewer">
　　　　　　<template scope="scope">
　　　　　　　　<img v-for="src in scope.images" :src="src" :key="src">
　　　　　　　　{{scope.options}}
　　　　　　</template>
　　　　</viewer>
　　　　<button type="button" @click="show">Show</button>
　　</div>
</template>
<script>
import 'viewerjs/dist/viewer.css'
import Viewer from "v-viewer/src/component.vue"
export default {
components: {
　　Viewer
},
data() {
　　images: ['1.jpg', '2.jpg']
},
methods: {
　　inited (viewer) {
　　this.$viewer = viewer
},
show () {
　　this.$viewer.show()
　　}
}
}
</script>

 

• 插件配置項

其它詳細配置項請參考 viewer.js 這篇文章：https://blog.csdn.net/liang_wf/article/details/102561670

1、name：String，默認值為 viewer

為了避免重名沖突，可以添加 name 配置項，代碼引入如下：

<template>
　　<div id="app">
　　　　<div class="images" v-vuer="{movable: false}">
　　　　　　<img v-for="src in images" :src="src" :key="src">
　　　　　　</div>
　　　　　　<button type="button" @click="show">Show</button>
　　</div>
</template>
<script>
import 'viewerjs/dist/viewer.css'
import Vuer from 'v-viewer'
import Vue from 'vue'
Vue.use(Vuer, {name: 'vuer'})
export default {
data() {
　　images: ['1.jpg', '2.jpg']
},
methods: {
show () {
　　const vuer = this.$el.querySelector('.images').$vuer
　　vuer.show()
}
}
}
</script>

2、defaultOptions：Object，默認值為 undefined

在初始化時需要修改 viewer.js 的全局默認配置項，代碼引入如下：

import Viewer from 'v-viewer'
import Vue from 'vue'
Vue.use(Viewer, {
defaultOptions: {
　　zIndex: 9999
}
})

在任何時候修改全局默認配置項，代碼如下：

import Viewer from 'v-viewer'
import Vue from 'vue'
Vue.use(Viewer)
Viewer.setDefaults({
　　zIndexInline: 2017
})

 

轉載自：傲凝