关于zx-image-view图片预览插件，支持旋转、缩放、移动的相关操作

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

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

源码地址：https://github.com/zx1984/image-view

演示地址：https://zx1984.github.io/image-view/dist/

默认键盘操作

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

滚动鼠标：缩放

注：支持自定义按键配置，详见参数说明。

# 效果图 preview

演示地址：https://zx1984.github.io/image-view/dist/

使用 use

npm

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

ES6+

import { ZxImageView } from 'zx-image-view'

浏览器Brower

<p 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"></p><script src="dist/js/zx-image-view.min.js"></script><script>
  // 初始化参数
  var options = {    // 见参数说明处
  };  // 图片数组1
  var imgArray1 = [    &#39;http://xxx.com/a.jpg&#39;,    &#39;http://xxx.com/b.jpg&#39;,    &#39;http://xxx.com/c.jpg&#39;,    &#39;http://xxx.com/d.jpg&#39;
  ];  // 图片数组2
  var imgArray2 = [
    {
      url: &#39;http://xxx.com/a.jpg&#39;,      // 初始化旋转角度
      angle: 90
    },
    {
      url: &#39;http://xxx.com/b.jpg&#39;,
      angle: 0
    },
    {
      url: &#39;http://xxx.com/c.jpg&#39;,
      angle: 180
    },
    {
      url: &#39;http://xxx.com/d.jpg&#39;
      angle: 90
    }
  ];</script>

使用方法 1

var ziv1 = new ZxImageView(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 ziv2 = new ZxImageView(imgArray2);

使用方法 3

var ziv3 = new ZxImageView();
ziv3.init(imgArray2);

使用方法 4

var ziv4 = new ZxImageView();// 业务场景，针对后台管理列表页，每条数据(动态)有多张图片，需独立预览，不需要多次实例化ZxImageView// 查看imgArray2第3张图片ziv4.view(2, imgArray2);

开发调试

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

参数 options

参数	类型	说明
backgroundOpacity	Floor	背景遮罩(黑色)透明度，取值0-1，默认值0.6
iconfont	String	iconfont图标字体css样式url地址(样式名见附录iconfont说明)
keyboard	Object	键盘按钮(前/后一张、缩放、旋转、关闭)配置
movable	Boolean	移动图片，默认值true
paginationable	Boolean	分页mouseover切换图片，默认值true
rotatable	Boolean	旋转图片，默认值true
scalable	Boolean	缩放图片，默认值true
showClose	Boolean	显示关闭预览窗口按钮，默认值true
showPagination	Boolean	显示分页栏，默认值true
showSwitchArrow	Boolean	显示左右切换箭头按钮，默认值true
showToolbar	Boolean	显示工具栏，默认值false

options.keyboard

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

注意：参数中只能包含有且一个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 ZxImageView(_config);

方法 methods

• destroy() 销毁当前图片查看dom对象

• init(imageArray, index) 初始化图片数据

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

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

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

附录

• iconfont样式名说明

字体样式.zx，图标样式如下图：

http://www.iconfont.cn/

• 支持自定义键盘按钮名/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
numpadpide	/分或除
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	鼠标滚动键

以上是关于zx-image-view图片预览插件，支持旋转、缩放、移动的相关操作的详细内容。更多信息请关注PHP中文网其他相关文章！