Parallax ImageScroll是一款效果非常炫酷的滚动背景图片视觉差特效jQuery插件。该背景图片视觉差插件使用CSS3 transform来制作动画效果，并在不支持CSS3属性的浏览器上提供回退方案。
该背景图片视觉差插件在移动触摸设备上不使用视觉差效果，并且图片会被相应的设置为小图片。它还能和AMD兼容，通过RequireJS来使用：
require(['jquery.imageScroll'], function (ImageScroll) {
$('.img-holder').each(function () {
new ImageScroll(this);
});
//or
//$('.img-holder').imageScroll();
});
安装
可以通过bower来安装这个视觉差特效插件。
bower install Parallax-ImageScroll
该图片背景视觉差特效插件需要jQuery1.8以上版本的jQuery。
使用方法
HTML结构
<div class="img-holder" data-image="anImage.jpg"></div>
<section><p>Content that "slides" on top of the images</p></section>
<div class="img-holder" data-image="anotherImage.jpg">[optional content to be displayed on top of the images]</div>
你可以通过HTML5 data属性或javascript来设置该插件的参数，参考后面的参数配置。
调用插件
在页面加载完毕之后，你可以在需要视觉差效果的图片上调用imageScroll方法来初始化该插件。
$('.img-holder').imageScroll();
配置参数
你可以通过传递一个参数对象来覆盖默认的参数配置。
$('.img-holder').imageScroll({
coverRatio: 0.5
});
或者通过HTML5 data属性来设置参数，data-optionname可用的参数有： image, width (mediaWidth), height (mediaHeight), cover-ratio (coverRatio), min-height (holderMinHeight), max-height (holderMaxHeight), extra-height (extraHeight)。
<div class="img-holder" data-image="anImage.jpg" data-cover-ratio="0.5"></div>
或者你也可以设置全局的参数。
$.fn.imageScroll.defaults.coverRatio = 0.5;
//AMD
ImageScroll.defaults.coverRatio = 0.5;
可用的参数有：
- image: null：显示的图片（这个参数最好通过data属性
data-img来设置）。 - imageAttribute: 'image'：图片的data属性名称。使用这个参数值来调用图片。
- container: $('body')：在那个容器中执行背景图片视觉差效果，默认是
<body>。 - windowObject: $(window)：窗口对象用于监听滚动和resize事件。
- speed: 0.2：背景图片视觉差效果的滚动速度。它是一个0-1之间的浮点数，数值越大滚动越快。
- coverRatio: 0.75 //75%：图片占整个屏幕的百分比。
- holderClass: 'imageHolder'：图片占位符的class名称。
- imgClass: 'img-holder-img'：图片的class名称。
- holderMinHeight: 200：图片的最小高度，单位像素。
- holderMaxHeight: null：图片的最大高度，单位像素。
- extraHeight: 0：附加到图片上的额外高度。这可以增加图片的显示高度。
- mediaWidth: 1600：图片的原始宽度。
- mediaHeight: 900：图片的原始高度。
- parallax: true：是否使用背景图片视觉差效果。例如在某些旧的浏览器上可以禁用视觉差效果。
- touch: false：这是在手机或平板等小屏幕触摸设备上的方案。没有视觉差效果，使用小图片来显示。
公共方法
disable()enable()refresh()destroy()
你可以在某个单独的实例或所有的实例上调用这些方法。
//Call method refresh on all the instances of the plugin
var instances = $('.img-holder');
instances.imageScroll('refresh');
//E.g. Call method refresh on the first image
//Alternative 1:
var instances = $('.img-holder');
var instance = $(instances.get(0));
instance.imageScroll('refresh');
//Alternative 2:
var instances = $('.img-holder');
var instance = $(instances.get(0)).data('plugin_imageScroll');
instance.refresh();
移动触摸设备
这个视觉差特效的过渡效果在移动触摸设备上不是十分的好，你可以在移动触摸设备上禁用视觉差效果，并提供一个回退版本，该版本没有视觉差效果，只显示图片。你可以通过外部库如Modernizr来检测是否是移动触摸设备，然后动态的设置参数来调整它们。
var touch = Modernizr.touch;
$('.img-holder').imageScroll({
imageAttribute: (touch === true) ? 'image-mobile' : 'image',
touch: touch
});
注意事项
如果你需要在作为背景视觉差效果的图片上添加内容，请为你的内容设置一个较高的z-depth属性。（添加自定义内容的效果只能在支持3d transforms的浏览器中实现）例如：
<div class="img-holder" data-image="anotherImage.jpg"><p style="-webkit-transform: translateZ(1px)">Hello world!</p></div>
