jQuery源碼之Callbacks的學(xué)習(xí)

var cb = $.Callbacks('memory');
cb.add(function(val){
 console.log('1: ' + val)
})
cb.fire('callback')
cb.add(function(val){
 console.log('2: ' + val)
})
// console

 ...
 // 以下變量和函數(shù) 外部無(wú)法修改，只能通過(guò)self暴露的方法去修改和訪問(wèn)
 var // Flag to know if list is currently firing
 firing,

 // Last fire value for non-forgettable lists
 // 保存上一次觸發(fā)callback的參數(shù)，調(diào)用add之后并用該參數(shù)觸發(fā)
 memory,

 // Flag to know if list was already fired
 fired,

 // Flag to prevent firing
 // locked==true fire無(wú)效 若memory非空則同時(shí)add無(wú)效
 locked,

 // Actual callback list
 // callback函數(shù)數(shù)組
 list = [],

 // Queue of execution data for repeatable lists
 // 保存各個(gè)callback執(zhí)行時(shí)的context和傳入的參數(shù)
 queue = [],

 // Index of currently firing callback (modified by add/remove as needed)
 // 當(dāng)前正觸發(fā)callback的索引
 firingIndex = -1,

 // Fire callbacks
 fire = function() {
 ...
 },
 
 // Actual Callbacks object
 self = {
 // Add a callback or a collection of callbacks to the list
 add: function() {
 ...
 },
 ...
 // Call all callbacks with the given context and arguments
 fireWith: function( context, args ) {
 if ( !locked ) {
 args = args || [];
 args = [ context, args.slice ? args.slice() : args ]; // :前為args是數(shù)組，:后是string
 queue.push( args );
 if ( !firing ) {
 fire();
 }
 }
 return this;
 },

 // Call all the callbacks with the given arguments
 fire: function() {
 self.fireWith( this, arguments );
 return this;
 },
 ...
 }

 add: function() {
 if ( list ) {

 // If we have memory from a past run, we should fire after adding
 // 如果memory非空且非正在觸發(fā)，在queue中保存memory的值,說(shuō)明add后要執(zhí)行fire
 // 將firingIndex移至list末尾 下一次fire從新add進(jìn)來(lái)的函數(shù)開(kāi)始
 if ( memory && !firing ) {
 firingIndex = list.length - 1;
 queue.push( memory );
 }

 ( function add( args ) {
 jQuery.each( args, function( _, arg ) {
 // 傳參方式為add(fn)或add(fn1,fn2)
 if ( jQuery.isFunction( arg ) ) {
 /**
 * options.unique==false
 * 或
 * options.unique==true&&self中沒(méi)有arg
 */
 if ( !options.unique || !self.has( arg ) ) {
 list.push( arg );
 }
 } else if ( arg && arg.length && jQuery.type( arg ) !== "string" ) {
 // 傳參方式為add([fn...]) 遞歸
 // Inspect recursively
 add( arg );
 }
 } );
 } )( arguments ); //arguments為參數(shù)數(shù)組 所以add的第一步是each遍歷

 //添加到list后若memory真則fire，此時(shí)firingIndex為回調(diào)隊(duì)列的最后一個(gè)函數(shù)
 if ( memory && !firing ) {
 fire();
 }
 }
 return this;
 }

// Fire callbacks
 fire = function() {

 // Enforce single-firing
 // 執(zhí)行單次觸發(fā)
 locked = locked || options.once;

 // Execute callbacks for all pending executions,
 // respecting firingIndex overrides and runtime changes
 // 標(biāo)記已觸發(fā)和正在觸發(fā)
 fired = firing = true;
 // 循環(huán)調(diào)用list中的回調(diào)函數(shù)
 // 循環(huán)結(jié)束之后 firingIndex賦-1 下一次fire從list的第一個(gè)開(kāi)始 除非firingIndex被修改過(guò)
 // 若設(shè)置了memory，add的時(shí)候會(huì)修改firingIndex并調(diào)用fire
 // queue在fireWith函數(shù)內(nèi)被更新，保存了觸發(fā)函數(shù)的context和參數(shù)
 for ( ; queue.length; firingIndex = -1 ) {
 memory = queue.shift();
 while ( ++firingIndex < list.length ) { 

 // Run callback and check for early termination
 // memory[0]是content memory[1]是參數(shù)
 if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&
 options.stopOnFalse ) {
 
 // Jump to end and forget the data so .add doesn't re-fire
 // 當(dāng)前執(zhí)行函數(shù)范圍false且options.stopOnFalse==true 直接跳至list尾 終止循環(huán)
 firingIndex = list.length;
 memory = false;
 }
 }
 }

 // 沒(méi)設(shè)置memory時(shí)不保留參數(shù)
 // 設(shè)置了memory時(shí) 參數(shù)仍保留在其中
 // Forget the data if we're done with it
 if ( !options.memory ) {
 memory = false;
 }

 firing = false;

 // Clean up if we're done firing for good
 if ( locked ) {

 // Keep an empty list if we have data for future add calls
 if ( memory ) {
 list = [];

 // Otherwise, this object is spent
 } else {
 list = "";
 }
 }
 },