开始使用 iSlider

使用iSlider最简单的办法是查阅我们提供的简易例子,请浏览DEMO文件夹中的内容。

创建一個容器

  1. <div id="iSlider-wrapper"></div>

准备一些数据

  1. var data = [
  2. {content: "imgs/1.jpg"},
  3. {content: "imgs/2.jpg"},
  4. {content: "imgs/3.jpg"}
  5. ];

载入iSlider

  1. <script src="iSlider.min.js"></script>

初始化一个iSlider

  1. var islider = new iSlider(document.getElementById('iSlider-wrapper'), data);

也可以

  1. var islider = new iSlider({
  2. dom : document.getElementById('iSlider-wrapper'),
  3. data : data
  4. });
  1. var islider = new iSlider(document.getElementById('iSlider-wrapper'), data, {
  2. dom : document.getElementById('iSlider-wrapper'),
  3. data : data
  4. });

iSlider 扩展

动画效果

如果您想加入更多效果,可以载入效果扩展库,并在初始化时配置参数,指定animateType

  1. <script src="iSlider.min.js"></script>
  2. <script src="iSlider.animate.min.js"></script>
  1. var islider = new iSlider({
  2. dom: document.getElementById("iSlider-wrapper"),
  3. data: list,
  4. isVertical: true,
  5. isLooping: false,
  6. isDebug: true,
  7. isAutoplay: false,
  8. animateType: 'rotate'
  9. });

插件

从2.X版本开始,iSlider加入插件注册机制,可以帮助您扩展自己需要的功能

  1. <script src="iSlider.min.js"></script>
  2. <script src="iSlider.plugin.dot.min.js"></script>
  1. var islider = new iSlider({
  2. dom: document.getElementById("iSlider-wrapper"),
  3. data: list,
  4. plugins: ['dot'],
  5. });

当然还可以为插件的初始化传递更多的自定义参数

  1. var islider = new iSlider({
  2. dom: document.getElementById("iSlider-wrapper"),
  3. data: list,
  4. plugins: [['dot', {background:'rgba(0,0,0,0)'}]],
  5. });

That’s it!

【注意】: 通过 npm 安装的iSlider默认不包含插件,在npm下使用插件:

  1. var iSlider = require('islider.js');
  2. require('../node_modules/islider.js/build/iSlider.plugin.button'); //引入button插件

官方提供的插件

button

场景切换按钮,用于切换到前(上)或后(下)一场景

dot

场景指示器,当前所处的位置及切换到某一场景功能

zoompic

移动端图片缩放,在图片的非背景模式中,通过对图片双击或双指放大,达到放大预览的效果

  • 已知的问题:恢复默认尺寸必须通过双击,双指缩小目前无法回到默认状态
BIZone

触控点边缘脱离识别区,虽然已经加入了mouseout和touchcancel的边缘处理,但是对于某些应用里,自定义的顶部(底部)菜单栏依然无能为力。识别区的意义在于可以主动的设置这些区域达到触摸脱离的效果。