一款基于JRoll开发的图集查看器插件
一款基于JRoll开发的图集查看器插件
注意!!!必须 JRoll v2.4.x 以上
若document.body
高度超出一屏,即当document.body.scrollTop
不为0时会影响本插件的滚动效果。
请将document.body
的css样式设为overflow:hidden;height:100%
,超出内容使用JRoll进行滑动
Tips:html的height为100%时,body的高度才能占满全屏
引入支持标签、CommonJS、AMD、CMD方式引入
标签<!-- 先引入JRoll再引入JRollViewer --> <script src="jroll.js"></script> <script src="jroll-viewer.js"></script> AMD
define(['jroll', 'jroll-viewer'], function (JRoll, JRollViewer) { var viewer = new JRollViewer('#viewer'{ JRoll: JRoll //不能确定引入顺序时可以参数形式将JRoll传给JRollViewer }) }) 使用说明
<!-- 基本用法 -->
<div id="viewer">
<img src="http://www.cdn.cn/1.png" jroll-viewer-image>
<img src="../images/2.jpg" jroll-viewer-image>
<img src="../images/3.gif">
</div>
<script>
var viewer = new JRollViewer('#viewer')
</script>
在div#viewer
容器里存放img
图片,图片必须带jroll-viewer-image
标记
new JRollViewer('#viewer')
将div#viewer
创建为JRollViewer实例容器
点击带jroll-viewer-image
标记的图片即可打开图片查看器
选项
new JRollViewer(el [, options])
键名 | 默认值 | 说明 |
---|---|---|
data | undefined | 小图dataset的属性作为大图读取的图片路径,若不指定该选项,默认读取小图src |
zoomMax | 图片原始值 | 图片最大缩放倍数,以window.innerWidth为1 |
afterSwitch | undefined | 图片切换后执行的回调函数,function (i) {...} i为切换后图片的索引值,索引从0开始 |
JRoll | window.JRoll | 用于异步引入JRoll,不能确保window.JRoll比window.JRollViewer先加载完成时使用 |
例:
<div id="viewer"> <img src="http://www.cdn.cn/1.png" data-big="http://www.cdn.cn/b1.png" jroll-viewer-image> </div> <script> var viewer = new JRollViewer('#viewer', { data: 'big', zoomMax: 3, JRoll: window.JRoll }) </script> 方法 show
// 打开第一张图片 viewer.show(0) // or 打开src为`../images/2.jpg`的图片 viewer.show('../images/2.jpg') // or 打开指定 img dom 的图片 viewer.show(document.getElementById('viewer').children[0])
一个参数,打开选中的图片
hide收起图片查看器
viewer.hide()
switch
手动切换图片,可利用该方法做图片自动轮播
viewer.switch(1, 200)
viewer.switch(index[, duration])
index 必填,索引值,要切换到哪张图片 duration 可选,过渡时间,当该值转为布尔类型不为false时会执行选项的afterSwitch
方法
技巧
自定义点击退出事件
目前默认点击图集查看器时会自动退出,如果需要点击时不退出,而是显示自己的头部导航等内容时,可以自行改写点击事件
在自己的退出按钮点击执行hide方法即可退出图集查看器
document.getElementById('jroll_viewer').onclick = function () { // 你的代码 } Log v0.2.2 (2017-03-10) 使用JRoll v2.4.7 新增的edgeRelease选项,修复body.scrollTop不为0时图片滑动失效的问题 v0.2.1 (2017-03-09) 优化滑动体验 修复屏幕旋转时报undefined的错误 v0.2.0 (2017-03-08) 添加afterSwitch方法 修改滑动阀值 v0.1.3 (2016-12-02) 超过5张图,将小圆点改为数字 v0.1.2 (2016-12-01) 添加data选项 v0.1.1 (2016-11-29) 修改了使用方式 允许多实例并存 每次打开查看器,重新生成要查看的图片,避免不断创建查看器 修复body.scrollTop不为0时错位的问题 v0.0.2 (2016-11-25) 完成
版权声明:
1、该文章(资料)来源于互联网公开信息,我方只是对该内容做点评,所分享的下载地址为原作者公开地址。2、网站不提供资料下载,如需下载请到原作者页面进行下载。