公告列表、圖片牆、合作夥伴 logo 牆,這類「一直滾、滾完再從頭來」的需求幾乎每個專案都會遇到。用 jQuery 實現的關鍵只有兩點:用 animate() 改變 marginTop 製造位移,滾完一輪後把首個元素搬到尾端並把位移歸零,視覺上就實現了無縫循環。
使用前請確認頁面已引入 jQuery 庫。下面由淺入深給出三個可直接落地的版本。
最樸素的寫法:每次上移一行的高度,動畫結束後把第一條移到最後,再把 marginTop 歸零。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>單行公告滾動</title>
<style type="text/css">
ul, li { margin: 0; padding: 0; list-style: none; }
#scrollDiv {
width: 300px; height: 25px; line-height: 25px;
border: 1px solid #ccc; overflow: hidden;
}
#scrollDiv li { height: 25px; padding-left: 10px; }
</style>
<script src="jquery.min.js"></script>
<script type="text/javascript">
function AutoScroll(obj) {
$(obj).find("ul:first").animate({ marginTop: "-25px" }, 500, function () {
$(this).css({ marginTop: "0px" }).find("li:first").appendTo(this);
});
}
$(document).ready(function () {
setInterval('AutoScroll("#scrollDiv")', 1000);
});
</script>
</head>
<body>
<div id="scrollDiv">
<ul>
<li>這是公告標題的第一行</li>
<li>這是公告標題的第二行</li>
<li>這是公告標題的第三行</li>
<li>這是公告標題的第四行</li>
<li>這是公告標題的第五行</li>
<li>這是公告標題的第六行</li>
<li>這是公告標題的第七行</li>
<li>這是公告標題的第八行</li>
</ul>
</div>
</body>
</html>
這個版本適合高程固定、只有一行的場景。缺點也很明顯:間隔與速度寫死,一次只能滾一行。
把邏輯收進 $.fn.extend,參數化行數、速度與間隔,並加上滑鼠移入暫停、移出繼續的行為——這對可讀性至關重要,使用者正在看的那一行不該被無情捲走。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>多行滾動</title>
<style type="text/css">
ul, li { margin: 0; padding: 0; list-style: none; }
#scrollDiv {
width: 300px; height: 100px; line-height: 25px;
border: 1px solid #ccc; overflow: hidden;
}
#scrollDiv li { height: 25px; padding-left: 10px; }
</style>
<script src="jquery.min.js"></script>
<script type="text/javascript">
(function ($) {
$.fn.extend({
Scroll: function (opt) {
if (!opt) var opt = {};
var _this = this.eq(0).find("ul:first");
var lineH = _this.find("li:first").height(), // 行高
line = opt.line ? parseInt(opt.line, 10) : parseInt(this.height() / lineH, 10), // 每次滾動行數,預設一屏
speed = opt.speed ? parseInt(opt.speed, 10) : 500, // 速度,數值越大越慢(毫秒)
timer = opt.timer ? parseInt(opt.timer, 10) : 3000; // 間隔(毫秒)
if (line == 0) line = 1;
var upHeight = 0 - line * lineH;
var scrollUp = function () {
_this.animate({ marginTop: upHeight }, speed, function () {
for (var i = 1; i <= line; i++) {
_this.find("li:first").appendTo(_this);
}
_this.css({ marginTop: 0 });
});
};
_this.hover(function () {
clearInterval(timerID);
}, function () {
timerID = setInterval(scrollUp, timer);
}).mouseout();
}
});
})(jQuery);
$(document).ready(function () {
$("#scrollDiv").Scroll({ line: 4, speed: 500, timer: 1000 });
});
</script>
</head>
<body>
<p>多行滾動演示:</p>
<div id="scrollDiv">
<ul>
<li>這是公告標題的第一行</li>
<li>這是公告標題的第二行</li>
<li>這是公告標題的第三行</li>
<li>這是公告標題的第四行</li>
<li>這是公告標題的第五行</li>
<li>這是公告標題的第六行</li>
<li>這是公告標題的第七行</li>
<li>這是公告標題的第八行</li>
</ul>
</div>
</body>
</html>
三個參數的含義值得記一下:line 決定一次捲動幾行,speed 控制動畫時長,timer 控制兩次捲動之間的停頓。三者搭配不當就會出現「一閃而過」或「慢得讓人著急」的觀感。
再往前一步,加上「向前 / 向後」按鈕。向上翻滾的思路同前;向下翻滾則反其道而行:先把最後幾行搬到最前面並隱藏,將 marginTop 設為負值,再動畫回到 0,視覺上就成了向下翻。另外要避免動畫進行中重複觸發,做法是點擊時先解綁、動畫結束再重新綁定。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>可控制前後翻頁的多行滾動</title>
<style type="text/css">
ul, li { margin: 0; padding: 0; list-style: none; }
#scrollDiv {
width: 300px; height: 100px; line-height: 25px;
border: 1px solid #ccc; overflow: hidden;
}
#scrollDiv li { height: 25px; padding-left: 10px; }
#btn1, #btn2 { cursor: pointer; margin-right: 10px; }
</style>
<script src="jquery.min.js"></script>
<script type="text/javascript">
(function ($) {
$.fn.extend({
Scroll: function (opt) {
if (!opt) var opt = {};
var _btnUp = $("#" + opt.up), // 向前按鈕
_btnDown = $("#" + opt.down), // 向後按鈕
timerID;
var _this = this.eq(0).find("ul:first");
var lineH = _this.find("li:first").height(),
line = opt.line ? parseInt(opt.line, 10) : parseInt(this.height() / lineH, 10),
speed = opt.speed ? parseInt(opt.speed, 10) : 500,
timer = opt.timer ? parseInt(opt.timer, 10) : 3000;
if (line == 0) line = 1;
var upHeight = 0 - line * lineH;
// 向上翻滾
var scrollUp = function () {
_btnUp.unbind("click", scrollUp);
_this.animate({ marginTop: upHeight }, speed, function () {
for (var i = 1; i <= line; i++) {
_this.find("li:first").appendTo(_this);
}
_this.css({ marginTop: 0 });
_btnUp.bind("click", scrollUp);
});
};
// 向下翻滾
var scrollDown = function () {
_btnDown.unbind("click", scrollDown);
for (var i = 1; i <= line; i++) {
_this.find("li:last").show().prependTo(_this);
}
_this.css({ marginTop: upHeight });
_this.animate({ marginTop: 0 }, speed, function () {
_btnDown.bind("click", scrollDown);
});
};
var autoPlay = function () { if (timer) timerID = window.setInterval(scrollUp, timer); };
var autoStop = function () { if (timer) window.clearInterval(timerID); };
_this.hover(autoStop, autoPlay).mouseout();
_btnUp.css("cursor", "pointer").click(scrollUp).hover(autoStop, autoPlay);
_btnDown.css("cursor", "pointer").click(scrollDown).hover(autoStop, autoPlay);
}
});
})(jQuery);
$(document).ready(function () {
$("#scrollDiv").Scroll({ line: 4, speed: 500, timer: 1000, up: "btn1", down: "btn2" });
});
</script>
</head>
<body>
<p>多行滾動演示:</p>
<div id="scrollDiv">
<ul>
<li>這是公告標題的第一行</li>
<li>這是公告標題的第二行</li>
<li>這是公告標題的第三行</li>
<li>這是公告標題的第四行</li>
<li>這是公告標題的第五行</li>
<li>這是公告標題的第六行</li>
<li>這是公告標題的第七行</li>
<li>這是公告標題的第八行</li>
</ul>
</div>
<span id="btn1">向前</span>
<span id="btn2">向後</span>
</body>
</html>
第一,li 的高度必須確定。插件靠 li:first().height() 計算位移,若高度由內容撐開而事先未知,需要在字型或圖片載入完成後再初始化。
第二,記得清除計時器。滑鼠移出、標頁切換、元件銷毀時若沒有 clearInterval,會留下幽靈計時器持續佔用資源。
第三,滾動的是圖片時要預留寬度。圖片滾動通常改為操作 marginLeft 並累加 li 的寬度,思路與此完全一致。
以上三個版本可以按需取用:只要簡單公告就抄第一段,要複用就封裝成插件,需要使用者主動控制就上第三版。