A repository of over 1000 quality jQuery plugins

jQuery .wrap()

Learn all about the jQuery function .wrap().

The .wrap() function can take any string or object that could be passed to the $() factory function to specify a DOM structure. This structure may be nested several levels deep, but should contain only one inmost element. A copy of this structure will be wrapped around each of the elements in the set of matched elements. This method returns the original set of elements for chaining purposes.

Consider the following HTML:

1
2
3
4
<div class="container">
<div class="inner">Hello</div>
<div class="inner">Goodbye</div>
</div>

Using .wrap(), we can insert an HTML structure around the inner <div> elements like so:

1
$( ".inner" ).wrap( "<div class='new'></div>" );

The new <div> element is created on the fly and added to the DOM. The result is a new <div> wrapped around each matched element:

1
2
3
4
5
6
7
8
<div class="container">
<div class="new">
<div class="inner">Hello</div>
</div>
<div class="new">
<div class="inner">Goodbye</div>
</div>
</div>

The second version of this method allows us to instead specify a callback function. This callback function will be called once for every matched element; it should return a DOM element, jQuery object, or HTML snippet in which to wrap the corresponding element. For example:

1
2
3
$( ".inner" ).wrap(function() {
return "<div class='" + $( this ).text() + "'></div>";
});

This will cause each <div> to have a class corresponding to the text it wraps:

1
2
3
4
5
6
7
8
<div class="container">
<div class="Hello">
<div class="inner">Hello</div>
</div>
<div class="Goodbye">
<div class="inner">Goodbye</div>
</div>
</div>