jQuery API

:animated Selector

animated selector

version added: 1.2jQuery(':animated')

Description: Select all elements that are in the progress of an animation at the time the selector is run.

Additional Notes:

  • Because :animated is a jQuery extension and not part of the CSS specification, queries using :animated cannot take advantage of the performance boost provided by the native DOM querySelectorAll() method. To achieve the best performance when using :animated to select elements, first select the elements using a pure CSS selector, then use .filter(":animated").

Example:

Change the color of any div that is animated.

<!DOCTYPE html>
<html>
<head>
  <style>
  div { background:yellow; border:1px solid #AAA; width:80px; height:80px; margin:0 5px; float:left; }
  div.colored { background:green; }
  </style>
  <script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
  <button id="run">Run</button>

  <div></div>
  <div id="mover"></div>
  <div></div>
<script>

    $("#run").click(function(){
      $("div:animated").toggleClass("colored");
    });
    function animateIt() {
      $("#mover").slideToggle("slow", animateIt);
    }
    animateIt();
</script>

</body>
</html>

Demo:

Support and Contributions

Need help with :animated Selector or have a question about it? Visit the jQuery Forum or the #jquery channel on irc.freenode.net.

Think you've discovered a jQuery bug related to :animated Selector? Report it to the jQuery core team.

Found a problem with this documentation? Report it to the jQuery API team.

* All fields are required
  • http://kstn.tk john

    has the function animateIt(); already existed ?
    I don’t know why we have to use it?

  • Poofy

    The function is there as a Callback so you can see it endlessly Toogle sliding up and down

  • Dusan Gledovic

    animateIt() recursive callback function. It is passed as callback within it's own body.

  • maystro

    Very usefull with callback function

  • neonsilk

    Does any one know… if I do a global $(“:animated”) selector, does jQuery actually traverse all nodes — or does it already know exactly what elements are being animated? I have a page where there are lots of simultaneous & overlapping animations, and I'm trying to be efficient as possible.

  • Fdg

    fgfdgfdg

  • http://twitter.com/ugureskici Uğur Eskici

    nice function