yummySlide
yummySlide 是一个专门针对于H5的滑页插件,based on jQuery,以下简要介绍使用方法
使用方法
<div class="y-slide"> <div class="container"> <div class="page"></div> <div class="page"></div> <div class="page"></div> </div> </div>
$('.y-slide').yummySlide({ mode: 'normal', direction: 'vertical', loop: true });
# 编译运行 $ gulp # 打包发布 $ gulp build
以上就能正确使用 yummySlide 了。
build
命令用于打包发布,请在原始html文件中按照htmlprocesss
定义的规范将注释写好,同时按照自己的情况去修改gulpfile.js
里的参数。打包之后的文件将存放到根目录下的build
文件夹。
CSS3动画
yummySlide.js内部对CSS3动画的加载做了优化与规定,yummySlide 建议将动画写入 ./less 目录下的 y-slide.less 文件中,按照已有动画的规范,将对应的动画名称写入元素的 data-animation 属性中。页面滑动到对应page时,yummySlide 会在页面滑动结束时来一次性加载动画,如果需要延迟动画,请自行在 animation 中添加animation-delay值。规范的书写有利用您管理自己的动画,也有利于充分利用 yummySlide 。
依赖文件
- jQuery.js or Zepto.js
- yummySlide.js yummySlide 依赖于jQuery,后来也支持了Zepto,建议使用1.6及以上版本的jQuery或者高版本的Zepto,同时,引入yummySlide的核心文件,yummySlide.js.
接口定义
yummySlide 目前定义了以下接口
API | USAGE | VALUE | DEFAULT | EXAMPLE |
---|---|---|---|---|
mode | 滑动的模式 | normal cover scale fade | normal | mode: 'normal' |
direction | 定义滑动的方向 | vertical horizontal | horizontal | direction: 'horizontal' |
loop | 是否循环滑动 | true false | false | loop: true |
order | 滑动的顺序 | sequential reverse [array] | sequential | order: [2, 1, 4, 3, 0, 5] |
custom | 如何开启滑动 | obj是绑定的对象,trigger是触发的方法 | null | custom : {obj: $('ele'), trigger: 'click'} |
init | 初始化时候执行的方法 | 对象 | null | init: { $('ele').show();} |
loadFn | 定义每一页加载成功之后执行的函数(例如一些js动画等等) | 页数:[{fn: 方法, arguments: 参数, delay: 延迟}] | null | loadFn : 1: [{ fn: count, arguments: [$('.page').eq(1).find('.number')], delay: 1000}] |