Usage of join(…):
wait for the end of the elements' current animations

How to wait for the end of the elements' current animations?

Compact syntax with timing methods:

1
$('.some').join().doSome().jQueryStuff();

The join() method also provides parameters for selecting the queue or to wait for an empty queue instead of the current animations' end.

Compare this to the old way with more syntactic fluff:

1
2
3
4
5
6
7
8
9
10
11
var waiting = $('.some').length;
if (!waiting) {
	$('.some').doSome().jQueryStuff();
} else {
  $('.some').queue(function(next){
    next();
    if (!--waiting) {
      $('.some').doSome().jQueryStuff();
    }
  });
}