callbacks.remove()

jQuery

previous page next page

callbacks.remove()

Categories: Callbacks Object

callbacks.remove( callbacks ) Returns: Callbacks

Description: Remove a callback or a collection of callbacks from a callback list.

  • version added: 1.7callbacks.remove( callbacks )

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

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

Example:

Use callbacks.remove() to remove callbacks from a callback list:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
                                  

                                    

                                      
                                        // a sample logging function to be added to a callbacks list
                                      
                                    

                                  

                                  

                                    

                                      var foo = function( value ) {
                                    

                                  

                                  

                                    

                                        console.log( "foo: " + 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"
                                      
                                    

                                  

                                  

                                    

                                       
                                    

                                  

                                  

                                    

                                      
                                        // remove "foo" from the callback list
                                      
                                    

                                  

                                  

                                    

                                      callbacks.remove( foo );
                                    

                                  

                                  

                                    

                                       
                                    

                                  

                                  

                                    

                                      
                                        // fire the items on the list again
                                      
                                    

                                  

                                  

                                    

                                      callbacks.fire( "world" );
                                    

                                  

                                  

                                    

                                       
                                    

                                  

                                  

                                    

                                      
                                        // nothing output as "foo" is no longer in the list
 POWERED BYHERONOTE
previous page start next page