callbacks.add()

jQuery

callbacks.add()


callbacks.add( callbacks ) Returns: Callbacks

Description: Add a callback or a collection of callbacks to a callback list.

  • version added: 1.7callbacks.add( callbacks )

    • callbacks
      Type: Function() or Array
      A function, or array of functions, that are to be added to the callback list.

This method returns the Callbacks object onto which it is attached (this).

Example

Use callbacks.add() to add new callbacks to a callback list:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
                                
// a sample logging function to be added to a callbacks list
var foo = function( value ) {
console.log( "foo: " + value );
};
// another function to also be added to the list
var bar = function( value ){
console.log( "bar: " + value );
};
var callbacks = $.Callbacks();
// add the function "foo" to the list
callbacks.add( foo );
// fire the items on the list
callbacks.fire( "hello" );
// outputs: "foo: hello"
// add the function "bar" to the list
callbacks.add( bar );
// fire the items on the list again
callbacks.fire( "world" );
// outputs:
// "foo: world"
// "bar: world"