jQuery метод .add()

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

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

jQuery синтаксис:

Синтаксис 1.7:

callbacks.add( callbacks )

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

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

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

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

Метод .add() объекта Callbacks — пример 1

Нажмите ▶. Измените JavaScript и запустите пример повторно. Используется jQuery 3.1.1.

index.html

HTML

<p>Результат выполнения выводится в консоль под примером.</p>

main.js

JavaScript

// возвращаем объект 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

style.css

CSS

body {
  margin: 16px;
  font:
    16px/1.5 system-ui,
    sans-serif;
  overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
  max-width: 100%;
}

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

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