control-freak-ide/Control-Freak-Documentation/jQuery/docs/entries/delay.json

{"name":"delay","type":"method","title":".delay()","deprecated":null,"removed":null,"desc":"Set a timer to delay execution of subsequent items in the queue.","categories":["effects/custom-effects","version/1.4"],"entries":[{"return":"jQuery","signatures":{"added":"1.4","argument":[{"desc":"An integer indicating the number of milliseconds to delay execution of the next item in the queue.","name":"duration","type":"Integer"},{"desc":"A string containing the name of the queue. Defaults to <code>fx</code>, the standard effects queue.","name":"queueName","optional":"true","type":"String"}]},"examples":{"desc":"Animate the hiding and showing of two divs, delaying the first before showing it.","css":"\n  div {\n    position: absolute;\n    width: 60px;\n    height: 60px;\n    float: left;\n  }\n  .first {\n    background-color: #3f3;\n    left: 0;\n  }\n  .second {\n    background-color: #33f;\n    left: 80px;\n  }\n","code":"\n$( \"button\" ).click(function() {\n  $( \"div.first\" ).slideUp( 300 ).delay( 800 ).fadeIn( 400 );\n  $( \"div.second\" ).slideUp( 300 ).fadeIn( 400 );\n});\n","html":"\n<p><button>Run</button></p>\n<div class=\"first\"></div>\n<div class=\"second\"></div>\n"},"longdesc":"\n    <p>Added to jQuery in version 1.4, the <code>.delay()</code> method allows us to delay the execution of functions that follow it in the queue. It can be used with the standard effects queue or with a custom queue. Only subsequent events in a queue are delayed; for example this will <em>not</em> delay the no-arguments forms of <code>.show()</code> or <code>.hide()</code>  which do not use the effects queue.</p>\n    <p>Durations are given in milliseconds; higher values indicate slower animations, not faster ones. The strings <code>'fast'</code> and <code>'slow'</code> can be supplied to indicate durations of 200 and 600 milliseconds, respectively.</p>\n    <p>Using the standard effects queue, we can, for example, set an 800-millisecond delay between the <code>.slideUp()</code> and <code>.fadeIn()</code> of <code>&lt;div id=\"foo\"&gt;</code>:</p>\n    <pre><code>\n$( \"#foo\" ).slideUp( 300 ).delay( 800 ).fadeIn( 400 );\n    </code></pre>\n    <p>When this statement is executed, the element slides up for 300 milliseconds and then pauses for 800 milliseconds before fading in for 400 milliseconds.</p>\n    <div class=\"warning\">\n      <p>\n        <strong>The <code>.delay()</code> method is best for delaying between queued jQuery effects. Because it is limited&#x2014;it doesn't, for example, offer a way to cancel the delay&#x2014;<code>.delay()</code> is not a replacement for JavaScript's native <a href=\"https://developer.mozilla.org/en/DOM/window.setTimeout\">setTimeout</a> function, which may be more appropriate for certain use cases.</strong>\n      </p>\n    </div>\n  "}]}