jQuery метод .add()

jQuery объект Callbacks

Определение и применение

jQuery метод .add() объекта Callbacks добаляет функцию, или массив функций обратного вызова в список обратных вызовов объекта. Этот метод возвращает объект обратного вызова к которому он присоединен (this).

jQuery синтаксис:

Синтаксис 1.7:

callbacks.add( callbacks )

callbacks - Function, или Array (массив функций)

Добавлен в версии jQuery

1.7

Значения параметров

ПараметрОписание
callbacksФункция, или массив функций, которые будут добавлены в список функций обратного вызова объекта.

Пример использования

// возвращаем объект Callbacks и инициализируем переменную этим значением
let myCallbacks = $.Callbacks();

// создаем функцию и инициализируем переменную этим значением
const fn = function( value ) {
	console.log( "fn - " + value );
};

// создаем массив, содержащий две стрелочные функции и инициализируем переменную этим значением
const arr = [(val) => console.log("arrFn1 - " + val), (val) => console.log("arrFn2 - " + val)];

// добаляем функцию обратного вызова в список обратных вызовов объекта
myCallbacks.add( fn ); 
 
// вызываем все ранее добавленные функции обратного вызова с заданным аргументом
myCallbacks.fire( "hello" );

// вывод в консоль (срабатывает одна функция):
fn1 -  hello

// добаляем массив функций обратного вызова в список обратных вызовов объекта
myCallbacks.add( arr );

// вызываем все ранее добавленные функции обратного вызова с заданным аргументом
myCallbacks.fire( "hello world" );

// вывод в консоль (срабатывает три функции):
fn - hello world
arrFn1 - hello world
arrFn2 - hello world

В этом примере мы рассмотрели базовое использование функции $.Callbacks(), которую мы вызвали без параметра и возвратили объект Callbacks. После этого инициализировали две переменные, первая содержит функцию, а вторая массив функций. С помощью метода .add() объекта Callbacks мы добавили функцию в список обратных вызовов объекта Callbacks, и с помощью метода .fire() этого объекта вызываем все ранее добавленные функции обратного вызова с заданным аргументом. В результате чего мы вывели в консоль текстовое сообщение.

После этого с помощью метода .add() объекта Callbacks мы добавили массив функций в список обратных вызовов объекта Callbacks, и с помощью метода .fire() этого объекта вызываем все ранее добавленные функции обратного вызова с заданным аргументом. В результате чего мы вывели в консоль три текстовых сообщения, таким образом уже три функции из нашего списка были вызваны.

jQuery объект Callbacks