Viewer.js 圖片預覽外掛
阿新 • • 發佈:2021-08-11
一、簡介
Viewer.js 是一款強大的圖片檢視器。
Viewer.js 有以下特點:
- 支援移動裝置觸控事件
- 支援響應式
- 支援放大/縮小
- 支援旋轉(類似微博的圖片旋轉)
- 支援水平/垂直翻轉
- 支援圖片移動
- 支援鍵盤
- 支援全屏幻燈片模式(可做屏保)
- 支援縮圖
- 支援標題顯示
- 支援多種自定義事件
Viewer.js 提供了純 JS 版本和 jQuery 版本,版本名字雖然一樣,但程式碼不一樣,不能通用。
二、下載
純JS版本:https://github.com/fengyuanchen/viewerjs
jQuery 版本:https://github.com/fengyuanchen/jquery-viewer
三、使用方法
直接引入檔案
Javascript版:
<link rel="stylesheet" href="css/viewer.min.css"> <script src="js/viewer.min.js"></script>jQuery版:
<link rel="stylesheet" href="css/viewer.min.css"> <script src="js/jquery.min.js"></script> <script src="js/viewer.min.js"></script>npm安裝
npm install viewerjsHtml結構
<!-- 單張圖片 --> <div> <img id="image" data-original="img/viewer1.jpg" src="img/viewer1.jpg" alt="圖片1"> </div> <!-- 多張圖片 --> <ul id="viewer"> <li><img data-original="img/viewer1.jpg" src="img/viewer1.jpg" alt="圖片1"></li>
JavaScript
Javascript版:
var image = new Viewer(document.getElementById('image'),{ url: 'data-original' }); var viewer = new Viewer(document.getElementById('viewer'),{ url: 'data-original' });jQuery 版:
$('#image').viewer({ url: 'data-original' }); $('#viewer').viewer({ url: 'data-original' });四、配置
名稱 | 型別 | 預設值 | 說明 |
---|---|---|---|
inline | 布林值 | false | 啟用 inline 模式 |
button | 布林值 | true | 顯示右上角關閉按鈕(jQuery 版本無效) |
navbar | 布林值/整型 | true | 顯示縮圖導航 |
title | 布林值/整型 | true | 顯示當前圖片的標題(現實 alt 屬性及圖片尺寸) |
toolbar | 布林值/整型 | true | 顯示工具欄 |
tooltip | 布林值 | true | 顯示縮放百分比 |
movable | 布林值 | true | 圖片是否可移動 |
zoomable | 布林值 | true | 圖片是否可縮放 |
rotatable | 布林值 | true | 圖片是否可旋轉 |
scalable | 布林值 | true | 圖片是否可翻轉 |
transition | 布林值 | true | 使用 CSS3 過度 |
fullscreen | 布林值 | true | 播放時是否全屏 |
keyboard | 布林值 | true | 是否支援鍵盤 |
interval | 整型 | 5000 | 播放間隔,單位為毫秒 |
zoomRatio | 浮點型 | 0.1 | 滑鼠滾動時的縮放比例 |
minZoomRatio | 浮點型 | 0.01 | 最小縮放比例 |
maxZoomRatio | 數字 | 100 | 最大縮放比例 |
zIndex | 數字 | 2015 | 設定圖片檢視器 modal 模式時的 z-index |
zIndexInline | 數字 | 0 | 設定圖片檢視器 inline 模式時的 z-index |
url | 字串/函式 | src | 設定大圖片的 url |
build | 函式 | null | 回撥函式,具體檢視演示 |
built | 函式 | null | 回撥函式,具體檢視演示 |
show | 函式 | null | 回撥函式,具體檢視演示 |
shown | 函式 | null | 回撥函式,具體檢視演示 |
hide | 函式 | null | 回撥函式,具體檢視演示 |
hidden | 函式 | null | 回撥函式,具體檢視演示 |
view | 函式 | null | 回撥函式,具體檢視演示 |
viewed | 函式 | null | 回撥函式,具體檢視演示 |