萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 無縫滾動插件 easysroll 使用詳解

頁面公告欄、圖片輪播、跑馬燈等場景常需無縫滾動效果。本文介紹一款輕量級 jQuery 插件 easysroll,支持四向滾動、淡入淡出、速度/間隔配置、懸停暫停,兼容主流瀏覽器(含 IE8+),適合快速集成到後台管理、企業官網等項目。

插件特性

  • 方向:left/right/top/bottom
  • 單次滾動數量 numberr
  • 動畫時長 delays、間隔 scrolling
  • 淡入淡出 fadein
  • 鼠標進入暫停 enterStop

快速開始

1. 引入依賴

<script src="js/jquery-1.7.2.min.js"></script>
<script src="js/scroll.js"></script>  <!-- 插件核心 -->

2. HTML 結構

<div class="content">
    <ul>
        <li><img src="img/1.jpg"></li>
        <li><img src="img/2.png"></li>
        <!-- 更多 li -->
    </ul>
</div>

3. CSS 關鍵點

.content { width: 1010px; height: 102px; overflow: hidden; border: 1px solid #4e83c2; margin: 50px auto; position: relative; }
.content ul { list-style: none; margin: 0; padding: 0; position: absolute; }  /* 必須 absolute 以便 JS 計算位移 */
.content ul li { width: 100px; height: 100px; border: 1px solid #ccc; float: left; cursor: pointer; }

4. 初始化配置

$(".content").easysroll({
    direction: "left",     // left/right/top/bottom
    numberr: "1",          // 每次滾動幾個 li
    delays: "1000",        // 動畫時長 ms
    scrolling: "1000",     // 間隔 ms
    fadein: false,         // 是否淡入淡出
    enterStop: true        // 懸停暫停
});

核心實現原理(節選)

(function($) {
    $.fn.easysroll = function(options) {
        var opts = $.extend({
            direction: "left", numberr: "1", delays: "1000", scrolling: "1000",
            fadein: false, enterStop: true
        }, options);

        return this.each(function() {
            var $container = $(this);
            var $ul = $container.find("ul");
            var $lis = $ul.children();
            var itemSize = (opts.direction === "left" || opts.direction === "right") ? $lis.outerWidth(true) : $lis.outerHeight(true);
            var visibleCount = Math.ceil((opts.direction === "left" || opts.direction === "right") ? $container.width() / itemSize : $container.height() / itemSize);
            var total = $lis.length;

            // 克隆首尾實現無縫
            $ul.append($lis.slice(0, visibleCount).clone())
               .prepend($lis.slice(-visibleCount).clone());

            var posProp = (opts.direction === "left" || opts.direction === "right") ? "left" : "top";
            var step = itemSize * parseInt(opts.numberr);
            var maxPos = total * itemSize;
            var current = visibleCount * itemSize; // 起始位置(已預留克隆區)

            $ul.css(posProp, -current);

            function animate() {
                var target = current + (opts.direction === "left" || opts.direction === "top" ? -step : step);
                var animObj = {}; animObj[posProp] = -target;
                $ul.animate(animObj, parseInt(opts.delays), function() {
                    current = target;
                    // 無縫邏輯:超出邊界瞬移回克隆區
                    if (current >= maxPos + visibleCount * itemSize) {
                        current = visibleCount * itemSize;
                        $ul.css(posProp, -current);
                    } else if (current < visibleCount * itemSize) {
                        current = maxPos;
                        $ul.css(posProp, -current);
                    }
                });
            }

            var timer = setInterval(animate, parseInt(opts.scrolling));

            if (opts.enterStop) {
                $container.hover(function() { clearInterval(timer); }, function() {
                    timer = setInterval(animate, parseInt(opts.scrolling));
                });
            }
        });
    };
})(jQuery);

常見問題與優化

  1. li 寬高不一:插件假設等寬/等高,若不一致需改用各項實際尺寸累加計算 step。
  2. 響應式容器:窗口 resize 時重新計算 visibleCount、itemSize 並重置位置。
  3. 觸屏支持:補充 touchstart/move/end 實現拖拽滾動,移動端體驗更佳。
  4. 銷毀實例:提供 destroy 方法清理定時器、克隆節點、事件綁定,防內存洩漏。

easysroll 代碼量小、邏輯清晰,適合作為學習無縫滾動原理的教材,也可直接用於對性能要求不極致的業務場景。複雜輪播建議使用 Swiper、Slick 等成熟庫。

copyright © 萬盛學電腦網 all rights reserved