基于编写jQuery的无缝滚动插件
更新时间：2025-10-28 08:42:18作者：zhao
编写jQuery的无缝滚动插件实现代码如下教程：
首先来看下html骨架，如下：
1 <div class="box">
2 <ul>
3 <li>111</li>
4 <li>222</li>
5 <li>333</li>
6 </ul>
7 </div>
2 <ul>
3 <li>111</li>
4 <li>222</li>
5 <li>333</li>
6 </ul>
7 </div>
结构简单明了，没什么说的。
讲下实现原理：
div box是最外层盒子，给它指定的宽高，记得给box添加一个 overflow:hidden (超出的内容隐藏)样式，因为滚动肯定是会超出box的。
我们通过js控制 ul 标签的margin 来实现滚动。横向滚动则是控制 margin-left ; 纵向滚动则是控制 margin-top;
初始状态时，我们还要进行条件判断，判断是否进行滚动。即： 当 ul 长度小于 外层 box 长度时不进行滚动，反之则进行滚动。
ul 的长度是通过计算得来的，即: ul 里面单个 li 的长度乘以 li 的个数。 ul_width = li_width * li_num;
之所以能实现无缝滚动，是因为每次滚动的长度刚好大于单个 li 的长度时，我们就将ul的第一个 li 移动到ul的最后，周而复始，无限循环(关于这
一点，你可以先不设置 overflow:hidden 来查看)。
讲个原理太TM考验我的表达能力了，希望我讲清楚了。
看插件的实现代码吧：
01 (function ($) {
02 $.fn.Scroll = function (options) {
03 //将当前上下文对象存入root
04 var root = this;
05
06 //默认配置
07 var settings = {
08 speed: 40, //滚动速度,值越大速度越慢
09 direction: "x" //滚动方向("x"或者"y" [x横向;y纵向])
10 };
11
12 //不为空，则合并参数
13 if (options)
14 $.extend(settings, options);
15
16
17 var timer = []; //计时器
18 var marquee; //滚动器(函数)
19 var isRoll; //判断是否滚动(函数)
20
21 var _ul = $("> ul", root); //ul标签
22 var _li = $("> ul > li", root); //li标签(集合)
23
24 var li_num = _li.length; //li标签个数
25 var li_first = _li.first(); //获取单个li标签
26
27
28 //判断为纵向还是横向，并进行相应操作
29 if (settings.direction == "x") {
30
31 var li_w = li_first.outerWidth(true); //单个li标签的宽度
32 var ul_w = li_w * li_num; //ul标签的宽度
33
34 _ul.css({ width: ul_w }); //设置ul宽度
35
36 marquee = function () {
37 _ul.animate({ marginLeft: "-=1" }, 0, function () {
38 var _mleft = Math.abs(parseInt($(this).css("margin-left")));
39 if (_mleft > li_w) { //滚动长度一旦大于单个li的长度
40 $("> li:first", $(this)).appendTo($(this)); //就把第一个li移到最后
41 $(this).css("margin-left", 0); //滚动长度归0
42 }
43 });
44 };
45 //ul长度小于box长度时则不滚动，反之滚动
46 isRoll = function (t) {
47 if (ul_w <= root.width())
48 clearInterval(t);
49 else
50 marquee();
51 }
52 }
53 else {
54 var li_h = li_first.outerHeight(true); //单个li标签的高度
55 var ul_h = li_h * li_num; //ul标签的高度
56
57 _ul.css({ height: ul_h }); //设置ul高度
58
59 marquee = function () {
60 _ul.animate({ marginTop: "-=1" }, 0, function () {
61 var _mtop = Math.abs(parseInt($(this).css("margin-top"))); //取绝对值
62 if (_mtop > li_h) {
63 $("> li:first", $(this)).appendTo($(this));
64 $(this).css("margin-top", 0);
65 }
66 });
67 };
68 //ul长度小于box长度时则不滚动，反之滚动
69 isRoll = function (t) {
70 if (ul_h <= root.height())
71 clearInterval(t);
72 else
73 marquee();
74 }
75 }
76
77 //遵循链式原则，并进行初始化
78 return root.each(function (i) {
79 //超出内容隐藏，防止用户没写overflow样式
80 $(this).css({ overflow: "hidden" });
81
82 timer[i] = setInterval(function () {
83 isRoll(timer[i]);
84 }, settings.speed);
85
86 //鼠标进入停止滚动，离开继续滚动
87 $(this).hover(function () {
88 clearInterval(timer[i]);
89 }, function () {
90 timer[i] = setInterval(function () {
91 isRoll(timer[i]);
92 }, settings.speed);
93 });
94
95 });
96
97 };
98 })(jQuery);
02 $.fn.Scroll = function (options) {
03 //将当前上下文对象存入root
04 var root = this;
05
06 //默认配置
07 var settings = {
08 speed: 40, //滚动速度,值越大速度越慢
09 direction: "x" //滚动方向("x"或者"y" [x横向;y纵向])
10 };
11
12 //不为空，则合并参数
13 if (options)
14 $.extend(settings, options);
15
16
17 var timer = []; //计时器
18 var marquee; //滚动器(函数)
19 var isRoll; //判断是否滚动(函数)
20
21 var _ul = $("> ul", root); //ul标签
22 var _li = $("> ul > li", root); //li标签(集合)
23
24 var li_num = _li.length; //li标签个数
25 var li_first = _li.first(); //获取单个li标签
26
27
28 //判断为纵向还是横向，并进行相应操作
29 if (settings.direction == "x") {
30
31 var li_w = li_first.outerWidth(true); //单个li标签的宽度
32 var ul_w = li_w * li_num; //ul标签的宽度
33
34 _ul.css({ width: ul_w }); //设置ul宽度
35
36 marquee = function () {
37 _ul.animate({ marginLeft: "-=1" }, 0, function () {
38 var _mleft = Math.abs(parseInt($(this).css("margin-left")));
39 if (_mleft > li_w) { //滚动长度一旦大于单个li的长度
40 $("> li:first", $(this)).appendTo($(this)); //就把第一个li移到最后
41 $(this).css("margin-left", 0); //滚动长度归0
42 }
43 });
44 };
45 //ul长度小于box长度时则不滚动，反之滚动
46 isRoll = function (t) {
47 if (ul_w <= root.width())
48 clearInterval(t);
49 else
50 marquee();
51 }
52 }
53 else {
54 var li_h = li_first.outerHeight(true); //单个li标签的高度
55 var ul_h = li_h * li_num; //ul标签的高度
56
57 _ul.css({ height: ul_h }); //设置ul高度
58
59 marquee = function () {
60 _ul.animate({ marginTop: "-=1" }, 0, function () {
61 var _mtop = Math.abs(parseInt($(this).css("margin-top"))); //取绝对值
62 if (_mtop > li_h) {
63 $("> li:first", $(this)).appendTo($(this));
64 $(this).css("margin-top", 0);
65 }
66 });
67 };
68 //ul长度小于box长度时则不滚动，反之滚动
69 isRoll = function (t) {
70 if (ul_h <= root.height())
71 clearInterval(t);
72 else
73 marquee();
74 }
75 }
76
77 //遵循链式原则，并进行初始化
78 return root.each(function (i) {
79 //超出内容隐藏，防止用户没写overflow样式
80 $(this).css({ overflow: "hidden" });
81
82 timer[i] = setInterval(function () {
83 isRoll(timer[i]);
84 }, settings.speed);
85
86 //鼠标进入停止滚动，离开继续滚动
87 $(this).hover(function () {
88 clearInterval(timer[i]);
89 }, function () {
90 timer[i] = setInterval(function () {
91 isRoll(timer[i]);
92 }, settings.speed);
93 });
94
95 });
96
97 };
98 })(jQuery);
基本的代码说明注释写的很清楚了。下面对个别知识点作下讲解：
1.) var timer=[]; 之前timer并不是声明为数组类型的，是在我写demo的时候，由于页面同时存在两个无缝滚动的应用(为了演示横向和纵向), 出现了bug。
因为他们两个共用了一个timer计时器，当鼠标进入其中一个时，另一个的timer也被clear了。之后修改代码将其声明为数组对象，再通过root.each()就实
现了每个插件应用都有自己独立的timer计时器，互不干扰。也就是说此插件支持页面同时存在多个无缝滚动应用。
2.) outerWidth() /outerHeight()函数。 这个函数比较强大，它获取的不仅仅是元素的宽度/高度，
实际上 outerWidth()=width+borderLeft+borderRight+marginLeft+marinRight;
当它设置为true后，即：outerWidth(true)，它也会将padding计算进来：
outerWidth()=width+borderLeft+borderRight+marginLeft+marinRight+paddingLeft+paddingRight;
怎么样，是不是很强大啊！
下面给出DEMO代码：
01 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
02 <html xmlns="http://www.w3.org/1999/xhtml">
03 <head>
04 <title></title>
05 <style type="text/css">
06 *{ margin:0; padding:0;}
07 ul,ul li{ list-style:none;}
08 .wrap{ width:1000px; margin:50px auto;}
09 .box1,.box2,.box3{ overflow:hidden; float:left;border:1px solid gray;}
10 .box1{ width:200px; height:450px;}
11 .box1 ul li{ width:200px; height:100px;}
12 .box2,.box3{ width:450px;height:150px; margin:40px;}
13 .box2 ul li,.box3 ul li{ width:100px; height:150px; float:left;}
14
15 </style>
16 </head>
17
18 <body>
19 <div class="wrap">
20
21 <div class="box1">
22 <ul>
23 <li>111纵向</li>
24 <li>222纵向</li>
25 <li>333纵向</li>
26 <li>444纵向</li>
27 <li>555纵向</li>
28 <li>666纵向</li>
29 </ul>
30 </div>
31
32 <div class="box2">
33 <ul>
34 <li>111横向</li>
35 <li>222横向</li>
36 <li>333横向</li>
37 <li>444横向</li>
38 <li>555横向</li>
39 <li>666横向</li>
40 </ul>
41 </div>
42
43 <div class="box3">
44 <ul>
45 <li>ul长度小于box长度，不滚动</li>
46 <li>222横向</li>
47 <li>333横向</li>
48 </ul>
49 </div>
50 </div>
51
52 <script type="text/javascript" src="js/jquery.js"></script>
53 <script type="text/javascript" src="js/jquery.similar.scroll.js"></script>
54 <script type="text/javascript">
55 $(function () {
56 //奇数背景设置为灰色
57 $('.box1 li:even,.box2 li:even,.box3 li:even').css({ backgroundColor: "gray" });
58
59 $(".box1").Scroll({ direction: "y" }); //设置为纵向滚动
60 $(".box2").Scroll(); //默认横向滚动
61 $(".box3").Scroll();
62 });
63 </script>
64 </body>
65 </html>
02 <html xmlns="http://www.w3.org/1999/xhtml">
03 <head>
04 <title></title>
05 <style type="text/css">
06 *{ margin:0; padding:0;}
07 ul,ul li{ list-style:none;}
08 .wrap{ width:1000px; margin:50px auto;}
09 .box1,.box2,.box3{ overflow:hidden; float:left;border:1px solid gray;}
10 .box1{ width:200px; height:450px;}
11 .box1 ul li{ width:200px; height:100px;}
12 .box2,.box3{ width:450px;height:150px; margin:40px;}
13 .box2 ul li,.box3 ul li{ width:100px; height:150px; float:left;}
14
15 </style>
16 </head>
17
18 <body>
19 <div class="wrap">
20
21 <div class="box1">
22 <ul>
23 <li>111纵向</li>
24 <li>222纵向</li>
25 <li>333纵向</li>
26 <li>444纵向</li>
27 <li>555纵向</li>
28 <li>666纵向</li>
29 </ul>
30 </div>
31
32 <div class="box2">
33 <ul>
34 <li>111横向</li>
35 <li>222横向</li>
36 <li>333横向</li>
37 <li>444横向</li>
38 <li>555横向</li>
39 <li>666横向</li>
40 </ul>
41 </div>
42
43 <div class="box3">
44 <ul>
45 <li>ul长度小于box长度，不滚动</li>
46 <li>222横向</li>
47 <li>333横向</li>
48 </ul>
49 </div>
50 </div>
51
52 <script type="text/javascript" src="js/jquery.js"></script>
53 <script type="text/javascript" src="js/jquery.similar.scroll.js"></script>
54 <script type="text/javascript">
55 $(function () {
56 //奇数背景设置为灰色
57 $('.box1 li:even,.box2 li:even,.box3 li:even').css({ backgroundColor: "gray" });
58
59 $(".box1").Scroll({ direction: "y" }); //设置为纵向滚动
60 $(".box2").Scroll(); //默认横向滚动
61 $(".box3").Scroll();
62 });
63 </script>
64 </body>
65 </html>
