zx-image-viewer图片查看插件-切换、旋转、缩放、移动

zx-image-viewer

图片预览插件，支持图片切换、旋转、缩放、移动...

浏览器支持：IE10+, (IE9不支持旋转功能)

效果预览：https://capricorncd.github.io...

源码地址：https://github.com/capricornc...

默认键盘操作

方向键：左left右right前后图片切换，上up下down顺时针逆时针旋转

滚动鼠标：缩放

支持自定义配置，详见页尾

使用 use

浏览器Brower

<div id="imgList">
  <img data-index="0" src="a.jpg">
  <img data-index="1" src="b.jpg">
  <img data-index="2" src="c.jpg">
  <img data-index="3" src="d.jpg">
</div>
<script src="dist/js/zx-image-viewer.min.js"></script>
<script>
  // 初始化参数
  var options = {
    // 见参数说明处
  };

  // 使用方法1
  var imgArray1 = [
    'http://xxx.com/a.jpg',
    'http://xxx.com/b.jpg',
    'http://xxx.com/c.jpg',
    'http://xxx.com/d.jpg'
  ];
  var ziv1 = new ZxImageViewer(options, imgArray1);

  // 点击缩略图，查看大图
  var $el = document.getElementById('imgList');
  $el.addEventListener('click', function (e) {
    if (this.nodeName === 'IMG') {
      // 获取图片索引
      var index = this.getAttribute('data-index');
      // 查看图片
      ziv1.view(index);
    }
  })

  // 使用方法2
  var imgArray2 = [
    {
      url: 'http://xxx.com/a.jpg',
      // 初始旋转角度
      angle: 90
    },
    {
      url: 'http://xxx.com/b.jpg',
      angle: 0
    },
    {
      url: 'http://xxx.com/c.jpg',
      angle: 180
    },
    {
      url: 'http://xxx.com/d.jpg'
      angle: 90
    }
  ];
  var ziv2 = new ZxImageViewer(imgArray2);

  // 使用方法3
  var ziv3 = new ZxImageViewer();
  ziv3.init(imgArray2);
</script>

npm

npm install zx-image-viewer --save-dev
# 或
npm i zx-image-viewer -D

ES6+

import { ZxImageViewer } from 'zx-image-viewer'

开发调试

npm run start
# http://localhost:9000/

效果图 preview

参数 options

参数	类型	说明
maskBackground	String	背景，默认值rgba(0, 0, 0, 0.6)
keyboard	Object	键盘按钮(前/后一张、缩放、旋转、关闭)配置
paginationable	Boolean	分页mouseover切换图片，默认值true
movable	Boolean	移动图片，默认值true
rotatable	Boolean	旋转图片，默认值true
scalable	Boolean	缩放图片，默认值true
showClose	Boolean	显示关闭预览窗口按钮，默认值true
showPagination	Boolean	显示分页栏，默认值true
showSwitchArrow	Boolean	显示左右切换箭头按钮，默认值true

options.keyboard

参数	类型	可选键名	说明
prev	String	任意键或mousewheel	上一张；为mousewheel时，next无效
next	String	任意键	下一张
scale	String或Array	任意键或mousewheel	图片缩放
rotate	String或Array	任意键或mousewheel	图片旋转
close	String	关闭图片查看器

注意：参数中只能包含有且一个mousewheel配置；任何配置均不支持组合键。

keyboard参数可选属性见页尾--附录

 // 初始化参数
let _config = {
  // 分页mouseover切换图片
  paginationable: true,
  // 显示关闭按钮
  showClose: true,
  // 显示上一张/下一张箭头
  showSwitchArrow: true,
  // 显示分页导航栏
  showPagination: true,
  // 缩放
  scalable: true,
  // 旋转
  rotatable: true,
  // 移动
  movable: true,
  // 键盘配置
  keyboard: {
    prev: 'a',
    next: 'd',
    rotate: ['up', 'down'],
    scale: 'mousewheel'
  }
}
new ZxImageViewer(_config);

方法 methods

• destroy() 销毁当前图片查看dom对象
• init(imageArray, index) 初始化图片数据

参数	类型	必须	说明
imageArray	Array	是	图片url数组
index	Number	否	imageArray的索引，默认显示的第index + 1张图片；默认为0; 如果index > imageArray.length将被忽略

• update(imageArray) 更新图片数据；与init()基本相同

参数	类型	必须	说明
imageArray	Array	是	图片url数组

• view(index, angle, imageArray) 查看第index + 1张图片

参数	类型	必须	说明
index	Number	是	imageArray的索引，显示的第index + 1张图片
angle	Number	否	图片旋转角度，90的整数倍
imageArray	Array	否	图片url数组，将更新初始化的图片数组

附录

支持自定义键盘按钮名/keyboard参数可选属性

属性	键名/说明
escape	Esc键
主键盘
backquote	~ 键
digit1	1(!) 键
digit2	2(@) 键
digit3	3(#) 键
digit4	4($) 键
digit5	5(%) 键
digit6	6(^) 键
digit7	7(&) 键
digit8	8(*) 键
digit9	9(() 键
digit0	0()) 键
equal	=(+) 键
minus	-(-) 键
a-z	A至Z键
bracketLeft	[({) 键
bracketRight	](}) 键
semicolon	;(:) 键
quote	'(") 键
backslash	反斜线 键
period	,(>) 键
comma	.(<) 键
slash	/(?) 键
space	空格键
数字键盘
numpad0	0
numpad1	1
numpad2	2
numpad3	3
numpad4	4
numpad5	5
numpad6	6
numpad7	7
numpad8	8
numpad9	9
numpadDivide	/分或除
numpadMultiply	*乘
numpadSubtract	-减
numpadAdd	+加
numpadDecimal	.小数点
编辑键区
insert	Insert 键
home	Home 键
end	End 键
pageUp	PageUp 键
pageDown	PageDown
delete	Delete 键
left	方向键左(ArrowLeft)
right	方向键右(ArrowRight)
up	方向键上(ArrowUp)
down	方向键下(ArrowDown)

鼠标滚动	说明
mousewheel	鼠标滚动键

Github

https://github.com/capricornc...