callbacks.disable.xml

<?xml version="1.0"?>
<entry name="callbacks.disable" type="method" return="undefined">
  <title>callbacks.disable()</title>
  <signature>
    <added>1.7</added>
  </signature>
  <desc>Disable a callback list from doing anything more.</desc>
  <longdesc>
    <h2 id="example-1">Example</h2>
    <p>Using <code>callbacks.disable()</code> to disable further calls being made to a callback list:</p>
    <pre><code>
// a sample logging function to be added to a callbacks list
var foo = function( value ){
    console.log( value );
}

var callbacks = $.Callbacks();

// add the above function to the list
callbacks.add( foo );

// fire the items on the list
callbacks.fire( 'foo' ); // outputs: foo

// disable further calls being possible
callbacks.disable();

// attempt to fire with 'foobar' as an argument
callbacks.fire( 'foobar' ); // foobar isn't output
</code></pre>
  </longdesc>
  <category slug="callbacks-object"/>
  <category slug="version/1.7"/>
</entry>