Pro PHP and jQuery by Jason Lengstorf.pdf - Computer Science ...

34
CHAPTER 2 ■ COMMON JQUERY ACTIONS AND METHODS
[ form # ]
Finally, to select a range of parents until a selector is matched, similar to .nextUntil() or
.prevUntil(), use .parentsUntil():
$(":checkbox").parentsUntil("form");
This returns all parent elements until the form element is encountered:
>>> $(":checkbox").parentsUntil("form");
[ label, fieldset ]
.add()
The .add() method is versatile and, therefore, a bit more complicated. Essentially, it allows you to add
additional elements to the existing jQuery object using a selector or a string of HTML.
To select all paragraphs and then add the span with class foo to the object, use the following:
$("p").add("span.foo");
This outputs the following:
>>> $("p").add("span.foo");
[ p, p.foo, p, p#bar, span.foo ]
The .add() method also allows you to create elements on the fly, like so:
$("p").add('This is a new span');
Executing the preceding code will output this:
>>> $("p").add('This is a new span');
[ p, p.foo, p, p#bar, span#bat ]
■ Note Notice that the element span#bat is faded in the console output. This happens because, while the element
exists in the jQuery object, it has not been appended to the DOM and, therefore, does not display on the page.
You'll learn how to add new elements to the DOM in the next section, “Creating and Inserting DOM Elements.”