.prependTo( target ) Returns: jQuery
Description: Insert every element in the set of matched elements to the beginning of the target.
-
version added: 1.0.prependTo( target )
-
targetA selector, element, HTML string, or jQuery object; the matched set of elements will be inserted at the beginning of the element(s) specified by this parameter.
-
The .prepend()
and .prependTo()
methods perform the same task. The major difference is in the syntax-specifically, in the placement of the content and target. With .prepend()
, the selector expression preceding the method is the container into which the content is inserted. With .prependTo()
, on the other hand, the content precedes the method, either as a selector expression or as markup created on the fly, and it is inserted into the target container.
Consider the following HTML:
1
2
3
4
5
|
|
We can create content and insert it into several elements at once:
1
|
|
Each inner <div>
element gets this new content:
1
2
3
4
5
6
7
8
9
10
11
|
|
We can also select an element on the page and insert it into another:
1
|
|
If an element selected this way is inserted into a single location elsewhere in the DOM, it will be moved into the target (not cloned):
1
2
3
4
5
|
|
If there is more than one target element, however, cloned copies of the inserted element will be created for each target after the first.
Example:
Prepend all spans to the element with the ID "foo" (Check .prepend() documentation for more examples)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
|