简要教程
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>