New method: .addBack (supersedes .andSelf)

[cowboy]

Ok. .andSelf is somewhat confusingly named. What is "self" anyways? Let's come up with a better name for this method, and in the process, add a signature by which the previous-set-of-elements-to-be-added may be filtered. How about .addPrior? It's like .add but it specifically adds elements from the prior set.

Here's a version, as a plugin, with some usage examples:  https://gist.github.com/1076570

Note: .andSelf should just be aliased to this new method, and documented as deprecated. We wouldn't need to change the docs for .andSelf, since it would still behave normally.

[addyosmani]

Marking as valid, switching to enhancement and opening for discussion.

[gibson042]

I like that this enhances the chain-stack analogy where filters/traversals/etc. push, .end() pops, and .prevObject peeks.

[gibson042]

I've thought a bit more about this, and would like to propose .addBack instead of .addPrior: #11128

[rwaldron]

Noticed this was unowned for 1.8

[dmethvin]

PR for discussion as .addBack().

 https://github.com/jquery/jquery/pull/777

[rwaldron]

Landed  https://github.com/jquery/jquery/commit/f76518e3931f7f2522a38bf37a7df24a620858fc

[cowboy]

I'm re-opening this, because the second half of the ticket, "...in the process, add a signature by which the previous-set-of-elements-to-be-added may be filtered..." wasn't addressed, and I'd hate to see it get lost because it's so useful.

See  https://gist.github.com/1076570 "find+filter" example for reference.

[dmethvin]

@cowboy can you submit a pull request?

[cowboy]

@dmethvin done.  https://github.com/jquery/jquery/pull/803

[Ben Alman]

jQuery#addBack supports an optional selector that can be used to filter the prior set before adding it back. Fixes #9800

Changeset: 02dd7c570bf4dbbdfc168f4352d04c667447be5d