图片查看器 Viewer.js

常用 js 插件 专栏收录该内容
5 篇文章 0 订阅
  • 插件简介

Viewer.js 是一款强大的图片查看器,提供了纯 JS 版本和 jQuery 版本,具有以下特点:

  1. 支持移动设备触摸事件
  2. 支持响应式
  3. 支持放大、缩小
  4. 支持旋转(类似微博的图片旋转)
  5. 支持水平、垂直翻转
  6. 支持图片移动
  7. 支持键盘
  8. 支持全屏幻灯片模式(可做屏保)
  9. 支持缩略图
  10. 支持标题显示
  11. 支持多种自定义事件

官网地址:http://fengyuanchen.github.io/viewerjs/

详细说明:http://www.dowebok.com/192.html

  • 使用步骤

1、下载并引入资源文件

GitHub 下载(JS 版本):https://github.com/fengyuanchen/viewerjs

GitHub 下载(jQuery 版本):https://github.com/fengyuanchen/viewer

注意:JS 版本和 jQuery 版本名字虽然一样,但代码不一样,不能通用,请正确下载需要的版本。

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>

2、Html 页面代码

<ul id="dowebok">
  <li><img src="img/small01.jpg" alt="图片1"></li>
  <li><img src="img/small02.jpg" alt="图片2"></li>
  <li><img src="img/small03.jpg" alt="图片3"></li>
</ul>

3、JavaScript 代码

JS 版本: 

//new Viewer(element[,options])
var viewer = new Viewer(document.getElementById('dowebok'));

jQuery 版本:

//$().viewer([options])
$('#dowebok').viewer();
  • options 参数配置

名称

类型

默认值

说明

backdrop

Boolean

String

true

启用 modal,为 false 的时候不支持点击背景关闭

button

Boolean

true

是否显示右上角的关闭按钮

navbar

Boolean

Number

true

是否显示底部导航栏

0 或 false:不显示

1 或 true:显示

2:当屏幕宽度大于 768px 时显示

3:当屏幕宽度大于 992px 时显示

4:当屏幕宽度大于 1200px 时显示

title

Boolean

Number

Function

Array

true

是否显示标题内容,默认显示 alt 属性内容和尺寸

0 或 false:不显示

1 或 true 或 function 或 array:显示

2:当屏幕宽度大于 768px 时显示

3:当屏幕宽度大于 992px 时显示

4:当屏幕宽度大于 1200px 时显示

function:在函数体内返回标题内容

array:第一个参数表示可见性(0-4),第二个参数表示标题内容

toolbar

Boolean

Number

Object

true

工具栏是否显示和布局

0 或 false:不显示

1 或 true:显示

2:当屏幕宽度大于 768px 时显示

3:当屏幕宽度大于 992px 时显示

4:当屏幕宽度大于 1200px 时显示

object:请看下面 Object 类型详解

className

String

''

添加到查看器的要元素的自定义类名

container

Element

String

'body'

将查看器置于 modal 模式的容器

只有在 inline 为 false 时才可以使用

filter

Function

null

过滤图像以便查看(图像是可见的,应返回 true)

fullscreen

Boolean

true

播放时是否全屏

initialViewIndex

Number

0

定义用于查看的图像的初始索引

inline

Boolean

false

是否启用 inline 模式

interval

Number

5000

播放间隔,单位为毫秒

keyboard

Boolean

true

是否启用键盘支持

loading

Boolean

true

加载图片时是否显示 loading 图标

loop

Boolean

true

是否可以循环查看图片

minWidth

Number

200

定义图片查看器的最小的宽度

minHeight

Number

100

定义图片查看器的最小的高度

movable

Boolean

true

是否可以拖动图片

zoomable

Boolean

true

是否可以缩放图片

rotatable

Boolean

true

是否可以旋转图片

scalable

Boolean

true

是否可以翻转图片

toggleOnDblclick

Boolean

true

当你放大或缩小图片时,是否可以双击还原

tooltip

Boolean

true

放大或缩小时,是否显示百分比的文字提示

transition

Boolean

true

是否使用 CSS3 过度

zIndex

Number

2015

在 modal 模式下定义查看器的 z-index 值

zIndexInline

Number

0

在 inline 模式下定义查看器的 z-index 值

zoomRatio

Number

0.1

鼠标滚动时的缩放比例

minZoomRatio

Number

0.01

最小缩放比例

maxZoomRatio

Number

100

最大缩放比例

url

String

Function

'src'

原始图像 URL

字符串:应该是图像元素的属性之一

函数:应该返回一个有效的图像 URL

ready

Function

null

当打开图片查看器时被触发,只会触发一次

show

Function

null

当打开图片查看器时被触发,每次都触发

shown

Function

null

当打开图片查看器完成时被触发,每次都会触发,在 show 之后

hide

Function

null

当关闭图片查看器时被触发,每次都会触发

hidden

Function

null

当关闭图片查看器完成时被触发,每次都会触发,在 hide 之后

view

Function

null

当显示图片时被触发,每次都会触发,在 shown 之后

viewed

Function

null

当显示图片完成时被触发,每次都会触发,在 view 之后

zoom

Function

null

当图片缩放时被触发

zoomed

Function

null

当图片缩放完成时被触发,在 zoom 之后

  • toolbar Object 类型详解

{ key: Number|Boolean }:显示或隐藏对应 key 的按钮,为 Number 的时候为可见性

{ key: String }:自定义按钮的大小

{ key: Function }:自定义按钮点击的处理

{ key: { show: Boolean|Number, size: String, click: Function } }:自定义按钮的每个属性

size 的取值范围:small、medium、default、large

key 值列表说明:

key 值名称

说明

zoomIn

放大图片的按钮

zoomOut

缩小图片的按钮

reset

重置图片大小的按钮

prev

查看上一张图片的按钮

next

查看下一张图片的按钮

play

播放图片的按钮

rotateLeft

向左旋转图片的按钮

rotateRight

向右旋转图片的按钮

flipHorizontal

图片左右翻转的按钮

flipVertical

图片上下翻转的按钮

  •  浏览器兼容

Chrome

Edge

Firefox

IE 8+

Opera

Safari

注意:JS 版本兼容 IE9+,jQuery 版本兼容 IE8+

  • 预览效果

  • 2
    点赞
  • 0
    评论
  • 5
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2021 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值