Skip to content

Commit e23e358

Browse files
committed
Specify that queued function called once for each matched element.
Fixes jquery#56
1 parent d2d537d commit e23e358

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

entries/queue.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -68,12 +68,12 @@ showIt();
6868
<desc>The new function to add to the queue, with a function to call that will dequeue the next item.</desc>
6969
</argument>
7070
</signature>
71-
<desc>Manipulate the queue of functions to be executed on the matched elements.</desc>
71+
<desc>Manipulate the queue of functions to be executed, once for each matched element.</desc>
7272
<longdesc>
7373
<p>Every element can have one to many queues of functions attached to it by jQuery. In most applications, only one queue (called <code>fx</code>) is used. Queues allow a sequence of actions to be called on an element asynchronously, without halting program execution. The typical example of this is calling multiple animation methods on an element. For example:</p>
7474
<pre><code>$('#foo').slideUp().fadeIn();</code></pre>
7575
<p>When this statement is executed, the element begins its sliding animation immediately, but the fading transition is placed on the <code>fx</code> queue to be called only once the sliding transition is complete.</p>
76-
<p>The <code>.queue()</code> method allows us to directly manipulate this queue of functions. Calling <code>.queue()</code> with a callback is particularly useful; it allows us to place a new function at the end of the queue.</p>
76+
<p>The <code>.queue()</code> method allows us to directly manipulate this queue of functions. Calling <code>.queue()</code> with a callback is particularly useful; it allows us to place a new function at the end of the queue. The callback function is executed once for each element in the jQuery set.</p>
7777
<p>This feature is similar to providing a callback function with an animation method, but does not require the callback to be given at the time the animation is performed.</p>
7878
<pre><code>$('#foo').slideUp();
7979
$('#foo').queue(function() {
@@ -151,4 +151,4 @@ $('#foo').queue(function() {
151151
<category slug="utilities"/>
152152
<category slug="version/1.2"/>
153153
</entry>
154-
</entries>
154+
</entries>

0 commit comments

Comments
 (0)