当前位置: 移动技术网 > IT编程>开发语言>JavaScript > jQuery滚动插件scrollable.js用法分析

jQuery滚动插件scrollable.js用法分析

2018年04月29日  | 移动技术网IT编程  | 我要评论

本文实例讲述了jquery滚动插件scrollable.js用法。分享给大家供大家参考,具体如下:

scrollable是一个灵活、轻量级用于创建滚动内容的jquery插件。任何内容(html、视频、文件、图片等...)都可以作为一个滚动项。支持水平与垂直两种滚动方向。

用途:滚动效果,可制作分步验证页面

以下scrollable.js方法说明描述:

方法名称
返回值 说明
getconf() object 返回scrollable的配置对象,并且可通过设置该对象的相关属性值来修改该配置对象的属性。
getindex() number 获取当前滚动项的索引号,0代表第一个元素,1代表第二个元素,以此类推。此外,需注意的是,如果获取到多个滚动项,那么将会只返回第一个滚动项的索引号。
getitems() jquery 返回所有的滚动项,结果以jquery对象的方式返回。
getitemwrap() jquery 获取滚动项的父节点,结果以jquery对象的方式返回。
getpageamount() number 获取当前滚动栏的分页数。
getpageindex() number 返回当前分页索引号。比如说,如果分页设置为5个滚动项/页,并且当前滚动项位置为7的话,那么将会返回1(第二页)
getroot() jquery 获取滚动项的上一级节点。
getsize() number 返回滚动项的数量。该方法等同于getconf().size
getvisibleitems() jquery 获取一个由当前可见滚动项组成列表,该列表为一个jquery对象,可见滚动项的数量由配置对象的size属性定义。
     
reload() api scrollable支持动态添加和删除滚动项的功能。在动态添加或删除滚动项以后,调用此方法来自动更新分页导航以及滚动项移动的相关信息。
prev() api 跳转到该滚动项的前一项(如果该滚动项不是第一个滚动项)
next() api 跳转到该滚动项的下一项(如果该滚动项不是最后一个滚动项)
seekto(index) api 跳转到指定索引处的滚动项。
move(offset) api 将处于当前状态(激活)的滚动项位置由当前滚动项向前/后移动offset。offset为正,则滚动项向右/下移动,否则,向左/上移动。比如:move(2),则处于当前状态的滚动项的索引由i滚动项转移至i+2滚动项。
prevpage() api 跳转到前一页(如果该页不是第一页)。
nextpage() api 跳转到后一页(如果该页不是最后一页)。
setpage(index) api 跳转到第index页。比如,index=2,那么会从当前页跳转到第3页。
movepage(offset) api 用于将显示页的位置由当前页切换到该页/后offset页,该方法其他解释类似于(offset)。
begin() api 跳转到第一个滚动项,相当于seekto(0)。
end() api 跳转到最后一个滚动项。
click(index) api 使第index个滚动项处于选中(激活)状态。
     
onbeforeseek(fn) api 参见配置对象的onbeforeseek相关说明
onseek(fn) api 参见配置对象的onseek相关说明

注意:上面方法表中prev()方法以下的方法除了表中携带的参数外,还包含两个隐含参数:speed和callback。其中speed参数是用于控制滚动项的动画效果持续时间的,而callback为其回调方法。具体实现可参见scrollable的prev()方法使用示例。

具体使用方法:

var scrollable=$("div.scrollable").scrollable();
//alert(scrollable.getconf().prev);//获取配置对象中的prev属性
scrollable.getconf().speed=200;//设置配置对象的speed属性
//alert(scrollable.getindex());//获取当前滚动项的索引
//alert(scrollable.getitems().length);//获取当前滚动项的数量
//alert(scrollable.getitemwrap().html());//获取包含滚动项的节点(class=scrollable),并将所有滚动项显示出来
//alert(scrollable.getpageamount());//获取当前滚动栏分页数
//alert(scrollable.getpageindex());//获取当前所在分页
//alert(scrollable.getroot().html());//获取滚动项的上一级节点(id=thumbs)
//alert(scrollable.getsize());
//alert(scrollable.getvisibleitems().length);//获取当前可见滚动项数量
scrollable.next();//如果有下一个滚动项,则跳转到下一个滚动项
scrollable.prev(3000,function(){return true});//跳转到前一滚动项
//var seekto= scrollable.click(0).seekto(2,1000,function(){
    //alert(this.getindex());
//});
//scrollable.move(2);
//scrollable.prevpage();//跳转到前一页
//scrollable.nextpage();//跳转到下一页
//scrollable.setpage(1);//跳转到下一页
//scrollable.begin();//跳转到第一个滚动项
//scrollable.end();//跳转到最后一个滚动项
scrollable.click(3);//使第四个滚动项处于选中状态
scrollable.onbeforeseek(function(){
    alert("you click the "+this.getindex()+"st scrollable item!");
});
$("#remove").click(function(){
    scrollable.getitems().filter(":last").remove();//删除最后一个滚动项
    scrollable.reload().prev();//自动更新相关配置信息,并跳转到被删除滚动项的前一项
});

另外,如果你的表单页面要自适应屏幕并且resize的话能让表单页面不至于偏离,可以使用 scrollable.seekto(index)来解决。

更多关于jquery相关内容感兴趣的读者可查看本站专题:《jquery常用插件及用法总结》、《jquery中ajax用法总结》、《jquery表格(table)操作技巧汇总》、《jquery扩展技巧总结》、《jquery常见经典特效汇总》及《jquery选择器用法总结

希望本文所述对大家jquery程序设计有所帮助。

如对本文有疑问, 点击进行留言回复!!

相关文章:

验证码:
移动技术网