jQuery新聞滾動外掛程式 jquery.roller.js

我在源碼裡給出了注釋,有什麼不足之處後或者可以改進的地方, 希望能夠大家留言探討...

(比較樸素):

複製代碼 代碼如下:
;(function($) {
$.fn.roller = function(options) {
var opts = $.extend({}, $.fn.roller.defaults, options),
// 通過迴圈隊列來管理滾動資訊
itemQueue = new Array();
return this.each(function(index) {
var $div = $(this).addClass('roller-container');
// 用給定的數組進行初始化
if(opts.items && Util.isArray(opts.items)) {
for(var i = 0, len = opts.items.length; i < len; i++) {
itemQueue.push($('<DIV class=roller-item></DIV>').append(buildLink(opts.items[i])));
}
} else {
//同樣可以用頁面元素進行初始化
}
// 把一開始要顯示的條目加入容器中
for(i = 0, len = opts.showNum; i < len; i++) {
if(isUp()) {
$div.append(itemQueue[i]);
} else {
$div.prepend(itemQueue[i]);
}
}
// 把已經加入容器的條目副本 放到迴圈隊列的尾部
for(i = 0, len = opts.showNum; i < len; i++) {
var temp = itemQueue.shift();
itemQueue.push(temp.clone());
}
// 取得一個滾動元素
var _item = $('.roller-item:first', this),
// 取得它的外圍高度 包括margin
_outHeight = _item.outerHeight(true),
// 容器的內容總高度
totalHeight = _outHeight * parseInt(opts.showNum, 10);
// 儲存初始marginTop值
opts.orginal_marginTop = parseInt(_item.css('margin-top'), 10);
if(isUp()) {
opts.anim_marginTop = opts.orginal_marginTop - _outHeight - parseInt($div.css('padding-top'), 10);
} else {
opts.anim_marginTop = opts.orginal_marginTop + _outHeight;
}
// 初始化容器樣式和事件
$div.css({
'height': totalHeight + 'px',
'overflow': 'hidden'
}).hover(function() {
// 滑鼠進入時 停止滾動
opts.hold = true;
}, function() {
// 滑鼠離開 重新開始滾動
opts.hold = false;
startRolling($(this));
}).trigger('mouseleave');
});
/**
* 滾動方向判斷
*/
function isUp() {
if(opts.direction === 'up') return true;
if(opts.direction === 'down') return false;
throw new Error('direction should be "up" or "down"');
}
/**
* 產生一個jQuery封裝的<A></A>
*/
function buildLink(item) {
var html = item.html;
delete item.html;
return $('<A></A>').attr(item).html(html);
}
function startRolling($div) {
setTimeout(function() {
// 是否停止滾動
if(!opts.hold) {
var first = null,
_funSelf = arguments.callee;
// 當前第一個元素
first = $div.find('.roller-item:first');
first.animate({marginTop: opts.anim_marginTop},
opts.interval,
function() {
// 從隊列中取出下一個條目
var temp = itemQueue.shift();
// 把它的副本放到隊列的尾部
itemQueue.push(temp.clone());
if(isUp()) {
// 移除當前第一個元素
first.remove();
// 把剛取出的條目append到容器中
$div.append(temp.hide());
} else {
// 移除當前最後一個元素
$div.find('.roller-item:last').remove();
// 讓當前第一個元素的marginTop恢複成初始值
first.css('margin-top', opts.orginal_marginTop + 'px');
// 把剛取出的條目prepend到容器中
$div.prepend(temp.hide());
}
temp.fadeIn(opts.interval - 50);
// 觸發下一個迴圈
setTimeout(_funSelf, opts.interval);
});
}
}, opts.interval);
};
};
//工具方法集合
var Util = {
toString: function(v) {
return Object.prototype.toString.apply(v);
},
// 判斷是否是Array
isArray : function(v){
return Util.toString(v) === '[object Array]';
}
};
// 滾動新聞預設配置
$.fn.roller.defaults = {
interval: 1000, // 滾動間隔
showNum: 5, // 一次顯示新聞數
hold: false, // 是否停止滾動
direction: 'up' // 滾動方向
};
})(jQuery);

看下頁面使用代碼
複製代碼 代碼如下:
<DIV id=container>
</DIV>
$('#container').roller({
showNum:4, //顯示個數
interval: 1500, //滾動的時間間隔
direction: 'down', //滾動方向
items: [{ //內容
title: 'ccav滾動新聞1', //a的title屬性
html: 'ccav滾動新聞1', //a的innerHTML
target: '_blank', //a的target
href: 'http://www.google.com.hk' //a的href
}, {
title: 'ccav滾動新聞2',
html: 'ccav滾動新聞2',
target: '_blank',
href: 'http://www.google.com.hk'
}, {
title: 'ccav滾動新聞3',
html: 'ccav滾動新聞3',
target: '_blank',
href: 'http://www.google.com.hk'
}, {
title: 'ccav滾動新聞4',
html: 'ccav滾動新聞4',
target: '_blank',
href: 'http://www.google.com.hk'
}, {
title: 'ccav滾動新聞5',
html: 'ccav滾動新聞5',
target: '_blank',
href: 'http://www.google.com.hk'
}, {
title: 'ccav滾動新聞6',
html: 'ccav滾動新聞6',
target: '_blank',
href: 'http://www.google.com.hk'
}]
});

線上示範 http://demo.jb51.net/js/2011/news_roller_Demo/jquery.roller.html
打包下載 /201106/yuanma/news_roller_Demo.rar