码迷,mamicode.com
首页 > 移动开发 > 详细

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

时间:2020-04-28 12:54:41      阅读:72      评论:0      收藏:0      [点我收藏+]

标签:es6   page   document   键盘   span   down   基本   city   lock   

zx-image-view

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

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

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

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

默认键盘操作

方向键:左leftright前后图片切换,上updown顺时针逆时针旋转

滚动鼠标:缩放

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

使用 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-view.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 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 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 ZxImageView(imgArray2);

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

npm

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

ES6+

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

开发调试

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

效果图 preview

技术图片

技术图片

参数 options

参数 类型 说明
backgroundOpacity Floor 背景遮罩(黑色)透明度,取值0-1,默认值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 ZxImageView(_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 AZ
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...

本文转载于:zx-image-view图片查看插件-切换、旋转、缩放、移动

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

标签:es6   page   document   键盘   span   down   基本   city   lock   

原文地址:https://www.cnblogs.com/jlfw/p/12793126.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!