DIV CSS 佈局教程網

自己動手寫 jQuery 插件:百分比動態色彩條
編輯:JQuery特效代碼     

以前沒寫過 jQuery 插件,這次動手時反覆對照著「如何開發插件」的文件寫了又改。做完之後回頭看,其實也沒那麼難。

寫這個的動機很實際:之前做問卷調查的應用時需要顯示統計比例,當時是直接堆一大段程式碼硬寫,又臭又長,光是除錯就花了一整個上午。既然之後的專案還會用到,不如包成插件。

這個功能邏輯簡單,正好適合當作寫插件的練習題。

基本上就是個簡化版的比例圖。

插件程式碼

; (function ($) {
$.fn.percentbar = function (o) {
var options1 = $.extend({
percent:[],//比例陣列,如:[0.5,0.4,0.6] 長度大於1時,按順序發配比例
bar_bgcolor:'#EFEFEF',//色彩條的背景顏色
bar_bordercolor:'#E2E2E2',//色彩條的邊框顏色
bar_borderwidth:1,//色彩條的邊框寬度
width:250,//色彩條的寬度
height:14,//色彩條的高度
callback:function(){}//回調函數(色彩條顯示完後)
},o);
var g=this.length;
var styleData=InitColor();
$(this).css({ "background": "none repeat scroll 0 0 #EFEFEF", "border": "1px solid #E2E2E2" ,"height": options1.height+"px","width": options1.width+"px","background-color":options1.bar_bgcolor,"border-color":options1.bar_bordercolor,"border-width":options1.bar_borderwidth+"px"});
$(this).each(function(index, element) {
$(element).append(" <p style=\"float: left; margin: 0;padding: 0;\"><span style=\"float: left;height: "+options1.height+"px;overflow: hidden;background-color:"+styleData[index]+";width:0px\"></span></p>");
if(g==index+1)
{
$(element).find("span").animate({ width: Math.round(options1.percent[index] * options1.width) }, "slow",options1.callback)
}
else
{
$(element).find("span").animate({ width: Math.round(options1.percent[index] * options1.width) }, "slow")
}
});
//初始化色彩條
function InitColor() {
var o = [];
var n = ["#5dbc5b", "#6c81b6", "#9eb5f0", "#a5cbd6", "#aee7f8", "#c2f263", "#d843b3", "#d8e929", "#e58652", "#e7ab6d", "#ee335f", "#fbe096", "#ffc535"];
var q = n.slice();
for (var p = 0, l = g; p < l; p++) {
var k = Math.floor(Math.random() * q.length);
o.push(q[k]);
q.splice(k, 1);
if (q.length == 0) {
q = n.slice()
}
}
return o
}
}
})(jQuery);

使用方式

$(".good").percentbar({ percent: [0.5, 0.4], width: 500 });
<div class="good"><div>

原本想把 CSS 抽到獨立檔案,後來還是直接寫進插件裡——這樣使用者只要引入一個 JS 檔就能跑,方便得多。

參數說明

  • percent:比例陣列(佔的比例),如 [0.5, 0.4, 0.6]。長度大於 1 時,按順序發配比例。
  • bar_bgcolor:色彩條的背景顏色。
  • bar_bordercolor:色彩條的邊框顏色。
  • bar_borderwidth:色彩條的邊框寬度。
  • width:色彩條的寬度。
  • height:色彩條的高度。
  • callback:回調函數,在色彩條動畫全部完成後執行。

幾個可以再打磨的地方

回調時機。目前只在「最後一個 span」的 animate 上掛 callback,這是因為各 span 動畫同時開始、同時結束,掛一個就夠。但如果日後要調整成序列動畫,就得改成用計數器或 .promise().done() 來判斷全部完成。

顏色隨機的取捨。InitColor() 用隨機挑色且不重複,視覺上有活潑感,但缺點是同一份資料每次重新整理顏色都不同,不利於圖表判讀。若要做成正式報表,建議改成依「陣列順序固定對應色票」。

幾個小 bug。第一,CSS 裡的 background 寫死了 #EFEFEF,會蓋掉傳入的 bar_bgcolor,應該移除或改用 options 的值。第二,example 中的 class=".good" 多了一個點,正確應為 class="good"。第三,percent 若陣列長度小於元素個數,options1.percent[index] 會是 undefined,導致寬度計算成 NaN;實用時應補上預設值。

整體來說,把一段重複使用的邏輯收攏成 $.fn 方法,最大的好處不只是少寫幾行,而是行為有了單一來源——之後要改配色或加功能,只需動一個地方。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved