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>