jquery.SuperSlide - 一款轻量级的JavaScript滑动插件
  • 分享到微信朋友圈
    X

关于SuperSlide

SuperSlide 致力于解决网站大部分特效展示问题,使网站代码规范整洁,方便维护更新。 网站上常用的“焦点图/幻灯片”“Tab标签切换”“图片滚动”“无缝滚动”等只需要一个SuperSlide即可解决! 从此无需网上苦苦寻觅特效,无需加载n个插件,无需害怕代码冲突,你需要的只是一个SuperSlide! 还可以多个SuperSlide组合创造更多效果哦~

如何使用

1、引用jQuery.js 和 jquery.SuperSlide.js

因为SuperSlide是基于jQuery的插件,所以前提必须先引用jQuery,再引用SuperSlide

<head>
    <script type="text/javascript" src="../jquery1.42.min.js"></script>
    <script type="text/javascript" src="../jquery.SuperSlide.2.1.3.js"></script>
</head>

2、编写HTML

以下是默认的HTMl结构,分别是 ".hd" 里面包含ul, ".bd" 里面包含ul

<div class="slideTxtBox">
    <div class="hd">
                <ul>
                    <li>教育</li><li>培训</li><li>出国</li></ul>
            </div>
    <div class="bd">
        <ul>
            <li><a href="#">SuperSlide2.0正式发布!</a></li>
        </ul>
        <ul>
            <li><a href="#">名师教作文:3妙招巧写高分</a></li>
        </ul>
        <ul>
            <li><a href="#">澳大利亚八大名校招生说明会</a></li>
        </ul>
    </div>
</div>

3、编写CSS,为HTML赋予样色

认真检查您的css,保证兼容大部分浏览器前提下再调用SuperSlide

.slideTxtBox{ width:450px; border:1px solid #ddd; text-align:left;  }
.slideTxtBox .hd{ height:30px; line-height:30px; background:#f4f4f4; padding:0 20px; border-bottom:1px solid #ddd;  position:relative; }
.slideTxtBox .hd ul{ float:left; position:absolute; left:20px; top:-1px; height:32px;   }
.slideTxtBox .hd ul li{ float:left; padding:0 15px; cursor:pointer;  }
.slideTxtBox .hd ul li.on{ height:30px;  background:#fff; border:1px solid #ddd; border-bottom:2px solid #fff; }
.slideTxtBox .bd ul{ padding:15px;  zoom:1;  }
.slideTxtBox .bd li{ height:24px; line-height:24px;   }
.slideTxtBox .bd li .date{ float:right; color:#999;  }

4、调用SuperSlide

在本例中,请在 “.slideTxtBox” div结束后立刻调用 SuperSlide,这样会得到最好的效果,避免整个页面加载后再调用 SuperSlide;
因为是默认HTML结构,所以参数都为默认值,不用填写titCell、mainCell等。

<script type="text/javascript">jQuery(".slideTxtBox").slide(); </script>
0cf138b3-9729-495c-a289-ede2d04c7311.png
效果图

参数说明

  • type slide 效果类型,可选"slide"||"menu",引入type:"menu"专门处理菜单/导航效果

  • defaultPlay true 默认是否执行效果(第一次运行是否执行效果)常用于导航/菜单

  • returnDefault false 鼠标移出容器,是否返回默认状态,常用于导航/菜单

  • mouseOverStop true 鼠标移到容器层(无缝滚动是mainCell)是否停止播放

  • playStateCell ".playState" 播放/暂停状态按钮,点击后会增加/删除"pauseState"类名用于控制样色。可参考 [2.22-真·全屏焦点图]

  • switchLoad null 内容切换加载,暂时只支持图片,必须配合后台程序使用。当为图片的时候switchLoad为图片实际路径的属性名称,例如switchLoad:"_src" [v2.1] 修复当scroll>1时,switchLoad无效的bug。

  • easing "swing" 缓动效果; [v2.1]更改默认效果为“swing”,使效果更流畅 所有

  • startFun null 每次切换效果开始时执行函数,用于处理特殊情况或创建更多效果。用法 startFun:function(i,c){ }; 其中i为当前分页,c为总页数 [v2.1]增加传递参数,startFun:function( i, c, slider, titCell, mainCell, targetCell, prevCell, nextCell ){},这样简写就方便了。例如 jQuery(".slideBox").slide({ startFun:function( i,c,s ){ s.show() } }); 这里的 s.show() 相当于 jQuery(".slideBox").show()

  • endFun null 每次切换效果结束时执行函数,用法和startFun一致

  • triggerTime 150 毫秒,titCell触发时间,默认150毫秒延迟,以防重复执行效果。若为0即鼠标移过titCell立刻执行效果

  • targetCell null 切换元素对象,处理内容切换元素非包裹状态下等情况,实现更多效果,处理更多情况,能和titCell、mainCell同时使用。只支持fade效果。[v2.1] 增加支持slideDown效果。

  • pageStateCell ".pageState" 分页状态对象,用于显示分页状态,例如:2/3

  • pnLoop true 前/后按钮是否继续循环,若为false则当翻动到最前/后页时,前/后按钮点击无效,同时增加prevStop/nextStop类名控制样色

  • opp false 默认反方向运动,例如 effect:"leftMarquee" 然后设置 opp:true,则效果为右滚动。常用于leftMarquee/topMarquee

  • autoPage false 程序自动分页,需结合titCell使用,若为true,则titCell为导航元素的包裹层对象。

  • titCell ".hd li" 导航元素对象(鼠标的触发元素对象)

  • mainCell ".bd" 切换元素的包裹层对象

  • effect "fade" 动画效果 [v1.0] fade:渐显; || top:上滚动;|| left:左滚动;|| topLoop:上循环滚动;|| leftLoop:左循环滚动;|| topMarquee:上无缝循环滚动;|| leftMarquee:左无缝循环滚动; [v2.0] fold:淡入淡出 [v2.1] slideDown:下拉效果

  • autoPlay false 自动运行

  • interTime 2500 毫秒;自动运行间隔。当effect为无缝滚动(topMarquee/leftMarquee)时,相当于运行速度。

  • delayTime 500 毫秒;切换效果持续时间(一次切换效果执行所用的时间长度)。

  • trigger "mouseover" titCell触发方式 || mouseover:鼠标移过触发;|| click:鼠标点击触发;

  • scroll 1 每次滚动个数。

  • vis 1 visible缩写,mainCell的可视范围个数,当实际内容个数少于可视个数的时候,不执行SuperSlide效果。v2.2 增值"auto",自适应宽度,仅适应于:scroll:1, effect:"left或leftLoop"情况(也就是通常的单图片滚动自适应宽度焦点图)

  • prevCell ".prev" 前一个/页按钮对象。

  • nextCell ".next" 后一个/页按钮对象。

  • defaultIndex 0 默认分页索引,0是第一页,deaultIndex:1 相当于默认显示第二页

  • titOnClassName "on" 当前titCell位置自动增加的class名称