Viewer.js Javascript/jQuery图片查看器

最新推荐文章于 2025-04-16 10:17:23 发布

郎涯技术

最新推荐文章于 2025-04-16 10:17:23 发布

阅读量1.3w

点赞数 3

分类专栏： Web全栈文章标签： js图片查看器

本文链接：https://blog.csdn.net/aoshilang2249/article/details/51824256

版权

Web全栈专栏收录该内容

55 篇文章

订阅专栏

Viewer.js是一款功能丰富的图片查看器，支持多种操作如放大、缩小、旋转等，并且兼容多种浏览器。提供纯JS和jQuery两个版本，适用于各种网页项目。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

简介

Viewer.js 是一款强大的图片查看器，像门户网站一般都会有各自的图片查看器，如果您正需要一款强大的图片查看器，也许 Viewer.js 是一个很好的选择。Viewer.js 有以下特点：

支持移动设备触摸事件
支持响应式
支持放大/缩小
支持旋转（类似微博的图片旋转）
支持水平/垂直翻转
支持图片移动
支持键盘
支持全屏幻灯片模式（可做屏保）
支持缩略图
支持标题显示
支持多种自定义事件

Viewer.js 提供了纯 JS 版本和 jQuery 版本，您可以任意选择。

浏览器兼容


IE8+ ✔	Edge ✔	Chrome ✔	Firefox ✔	Opera ✔	Safari ✔

注意：JS 版本兼容 IE9+，jQuery 版本兼容 IE8+。

使用方法

1、引入文件

JS 版本：

<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>

注意：JS 版本和 jQuery 版本名字虽然一样，但代码不一样，不能通用，请到 github 上下载需要的版本。

2、HTML

<ul id="dowebok">
    <li><img src="img/tibet-1.jpg" alt="图片1"></li>
    <li><img src="img/tibet-2.jpg" alt="图片2"></li>
    <li><img src="img/tibet-3.jpg" alt="图片3"></li>
    <li><img src="img/tibet-4.jpg" alt="图片4"></li>
    <li><img src="img/tibet-5.jpg" alt="图片5"></li>
    <li><img src="img/tibet-6.jpg" alt="图片6"></li>
</ul>

3、JavaScript

JS 版本：

var viewer = new Viewer(document.getElementById('dowebok'));

jQuery 版本：

$('#dowebok').viewer();

配置

名称	类型	默认值	说明
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	回调函数，具体查看演示

GitHub 地址：

JS 版本：https://github.com/fengyuanchen/viewerjs
jQuery 版本：https://github.com/fengyuanchen/viewer

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="x-ua-compatible" content="ie=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="description" content="A simple jQuery image viewing plugin.">
  <meta name="keywords" content="HTML, CSS, JS, JavaScript, jQuery plugin, image viewing, front-end, frontend, web development">
  <title>Viewer</title>
  <link rel="stylesheet" href="/./Public/jsLibs/viewer/dist/viewer.css">

  <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
  <!--[if lt IE 9]>
  <script src="/./Public/jsLibs/html5shiv.min.js"></script>
  <script src="/./Public/jsLibs/respond.min.js"></script>
  <![endif]-->

  <!-- Scripts -->
  <script src="/./Public/jsLibs/jquery.min.js"></script>
  <script src="/./Public/jsLibs/viewer/dist/viewer.js"></script>
</head>

<body>
<!--[if lt IE 8]>
<p class="browserupgrade">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
<![endif]-->

<div>
  <img class="image" src="/./Public/imgs/imgView/tibet-1.jpg" alt="图片1">
</div>

<script>
  //不显示缩略图导航
  $('.image').viewer({
    navbar: 0
  });
</script>

</body>
</html>