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 })
轉載自：傲凝
浙公網安備 33010602011771號