本篇較為詳細地分析 jQuery 源碼中的 addClass() 方法,搭配程式碼示範供參考。addClass 是掛在 jQuery 原型物件(jQuery.fn 即 jQuery.prototype)上的方法。
jQuery.fn.extend({
addClass: function( value ) {
var classes, elem, cur, clazz, j, finalValue,
i = 0,
//this 為準備添加 class 的 jQuery 物件,len 為其陣列長度。
len = this.length,
//proceed 用來判斷 value 是否為非空字串:其他型別最後都會回傳 false 或可隱式轉為 false 的值。
proceed = typeof value === "string" && value;
//若 value 是 Function 型別,則透過 each 迭代,將回傳值再次呼叫 addClass。
if ( jQuery.isFunction( value ) ) {
return this.each(function( j ) {
//this 為當前 DOM 物件,j 為索引;value.call 的回傳值會再次呼叫 addClass。
jQuery( this ).addClass( value.call( this, j, this.className ) );
});
}
//proceed 為非空字串時進入 if 區塊。rnotwhite = /(\S+/g) 全局匹配非空白字元。
if ( proceed ) {
classes = ( value || "" ).match( rnotwhite ) || [];
//開始遍歷,為每一個 DOM 物件添加類。
for ( ; i < len; i++ ) {
elem = this[ i ];
//cur 取目前元素現有的 class(前後補空格並正規化空白字元)。
cur = elem.nodeType === 1 && ( elem.className ?
( " " + elem.className + " " ).replace( rclass, " "):
" ");
if ( cur ) {
j = 0;
//循環檢查要添加的類是否已存在,不存在才添加。
while ( (clazz = classes[j++]) ) {
if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
cur += clazz + " ";
}
}
//去掉頭尾空白,並避免重複渲染相同的類。
finalValue = jQuery.trim( cur );
if ( elem.className !== finalValue ) {
elem.className = finalValue;
}
}
}
}
//回傳該 jQuery 物件,以便鏈式調用。
return this;
}
});
從源碼可見,addClass() 支援字串與函數兩種傳入方式,並會自動去重與正規化空白,避免重複添加相同類名,希望這份解析對你的開發有所幫助。