what does “return this.each()” do in jQuery?

Question

I\'m looking at a jQuery plugin, which has a single function. After setting up the appropriate defaults though a constructor argument the function defines a couple of helper fu

Answer 1

this make it possible to keep objects chain, so you can call jquery methods like this:

$("selector").css().mouseover().etc().blahblah();

Answer 2

.each returns the elements it was called on, so in this case, it is probably to maintain the ability of methods to be chained on that selector. That means that if the plugin'S method is called foo, you should be able to do

$("mySelector").foo().show();

Because foo returned the result of .each which is basically $("mySelector").

Hope that made sense.

Answer 3

It allows for one to call a plugin or an event on a bunch of elements and then apply that same function or event to all of them

So if you do:

$('.selector').myPlugin();

And if, let us say, .selector contains 10 elements, all 10 elements would get whatever myPlugin does.

---

The reason for returning that .each statement is because .each() returns whatever it was given and it allows you to chain multiple functions and plugins together on one jQuery element.

For example:

$('.selector').myPlugin().yourPlugin();

Answer 4

It makes functions chainable

http://docs.jquery.com/Plugins/Authoring#Maintaining_Chainability

Answer 5

It returns the JQuery object which method is called on as stated in the docs. So you can call another method on the returned value.

// without method chaining
myobject.a()
myobject.b()
myobject.c()

// with method chaining
myobject.a().b().c();

See method chaining and fluent interface