Home

Awesome

jQuery cxScroll

一款基于jQuery的无缝滚动插件,可自定义外观及调用参数,兼容主流浏览器。

版本:

注意事项:

  1. 内部会自动创建 prev 及 next 切换按钮,也可以在外部直接创建,若外部已创建或设置 prevBtn:false 及 nextBtn:false ,内部将跳过此步骤;
  2. 若(滚动的列表宽度 ≤ 父元素的宽度),则不会自动创建 prev 及 next 切换按钮,也不会自动滚动。

文档:http://code.ciaoca.com/jquery/cxScroll/

示例:http://code.ciaoca.com/jquery/cxScroll/demo/

使用方法

CSS 样式结构

除必要属性设置外,其他样式均可自行设置。

/* 横向滚动基本样式 */
.cxscroll{}
.cxscroll .box{overflow:hidden;width:600px;}
.cxscroll .list{overflow:hidden;width:9999px;}
.cxscroll .list li{float:left;width:200px;height:100px;}
.cxscroll .prev{}
.cxscroll .next{}

/* 纵向滚动基本样式 */
.cxscroll{}
.cxscroll .box{overflow:hidden;height:300px;}
.cxscroll .list{}
.cxscroll .list li{height:100px;}
.cxscroll .prev{}
.cxscroll .next{}

DOM 结构

<div id="element_id" class="cxscroll">
    <div class="box">
        <ul class="list">
            <li></li>
            <li></li>
            ...
            <li></li>
        </ul>
    </div>
    <!-- 控制按钮会自动创建,可省略 -->
    <a class="prev"></a>
    <a class="next"></a>
</div>

调用 cxScroll

$("#element_id").cxScroll();

options 参数说明

名称默认值说明
direction'right'滚动方向。可设置为:"left", "right", "top", "bottom"
easing'swing'缓动方式
step1滚动步长
accel200手动滚动速度 (ms),点击控制按钮滚动的速度。
speed800自动滚动速度 (ms)
time4000自动滚动间隔时间 (ms)
autotrue是否自动滚动
hoverLocktrue鼠标移入移出锁定。鼠标进入区域内时停止自动轮播,离开后恢复自动轮播(仅在 auto 为 true 时有效)
prevBtntrue是否使用 prev 按钮
nextBtntrue是否使用 next 按钮

API接口

var Api;
$('#element_id').cxScroll(function(api){
  Api = api;
});
// 或者作为第二个参数传入
$('#element_id').cxScroll({
  minus: true,
  plus: true
}, function(api){
  Api = api;
});
名称说明
play()开始自动播放
stop()停止自动播放
prev(speed)向前滚动。speed 为滚动速度(ms)
next(speed)向后滚动。speed 为滚动速度(ms)