本文详细介绍 Viewer.js 这款强大的图像查看插件，支持纯JS与jQuery双版本。内容涵盖其核心功能如触摸、响应式、旋转缩放及全屏幻灯片模式，并提供从GitHub下载、npm安装到HTML结构与JavaScript初始化的完整使用指南，同时解析关键配置参数与常见应用场景。
Viewer.js 简介与特性
一、简介
Viewer.js 是一款功能强大的图片查看器。
Viewer.js 具备以下主要特性：
- 支持移动设备的触摸事件 - 支持响应式布局 - 支持图片放大与缩小 - 支持图片旋转（效果类似微博图片旋转） - 支持水平与垂直翻转 - 支持图片拖拽移动 - 支持键盘操作 - 支持全屏幻灯片模式（可用作屏保） - 支持缩略图导航 - 支持显示图片标题 - 支持多种自定义事件 Viewer.js 提供纯 JavaScript 版本和 jQuery 版本，两者名称相同但代码实现不同，互不通用。
下载资源与演示地址
二、下载
纯JS版本：
下载地址：https://github.com/fengyuanchen/viewerjs
演示地址：http://demo.jb51.net/js/viewerjs/js/
jQuery 版本：
下载地址：https://github.com/fengyuanchen/jquery-viewer
演示地址：http://demo.jb51.net/js/viewerjs/jquery/
安装与初始化使用方法
三、使用方法
1、直接引入文件
Javascript版：
<link rel="stylesheet" href="css/viewer.min.css" rel="external nofollow" rel="external nofollow" > <script src="js/viewer.min.js"></script>
jQuery版：
<link rel="stylesheet" href="css/viewer.min.css" rel="external nofollow" rel="external nofollow" > <script src="js/jquery.min.js"></script> <script src="js/viewer.min.js"></script>
2、npm安装
npm install viewerjs
3、Html结构
<!-- 单张图片 -->
<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>
<li><img data-original="img/viewer2.jpg" src="img/viewer2.jpg" alt="图片2"></li>
<li><img data-original="img/viewer3.jpg" src="img/viewer3.jpg" alt="图片3"></li>
<li><img data-original="img/viewer4.jpg" src="img/viewer4.jpg" alt="图片4"></li>
<li><img data-original="img/viewer5.jpg" src="img/viewer5.jpg" alt="图片5"></li>
<li><img data-original="img/viewer6.jpg" src="img/viewer6.jpg" alt="图片6"></li>
</ul>4、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 | 回调函数，具体查看演示 |
下面是其他网友的补充
需求：在信息详情页面实现点击图片可以预览
准备工作：引入jquery.js、viewer.js 、viewer.css
代码如下：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>viewer.js图片预览</title>
<script type="text/javascript" src="skin/jquery.js"></script>
<link rel="stylesheet" href="skin/js/viewer/viewer.css" rel="external nofollow" >
<script src="skin/js/viewer/viewer.js"></script>
</head>
<body>
<img id="viewer" src="skin/img/threeHuan.png" alt="hello"></li>
</body>
<script>
$('#viewer').viewer();
</script>
</html>注意：js中初始化viewer的时候位置要放到img标签后边
效果：
到此这篇关于viewer.js一个强大的基于jQuery的图像查看插件(支持旋转、缩放)的文章就介绍到这了,更多相关图像查看插件内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！