jQuery - wrapAll( elem ) Method



The wrapAll( elem ) method wraps all the elements in the matched set into a single wrapper element.

Here is the simple syntax to use this method −

selector.wrapAll( elem )


Here is the description of all the parameters used by this method −

  • elem − A DOM element that will be wrapped around the target.


Following is a simple example a simple showing the usage of this method. This wraps all the squares with a new square −


      <title>The jQuery Example</title>
      <script type = "text/javascript" 
         src = "http://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
      <script type = "text/javascript" language = "javascript">
         $(document).ready(function() {

            $(".wrapper").click(function () {
               var newcolor = $(this).css('background-color');
               $(".inner").wrapAll("<div class = 'newinner' 
                  style = 'border:2px solid "+newcolor+"';></div>");
         .wrapper{ margin:10px;padding:12px; border:2px solid #666; }
         .inner{ padding:20px; border:2px solid #666; }

      <p>Click on any square below to see the result −</p>
      <div class = "inner" id = "destination">Element-1</div>
      <div class = "inner" id = "destination">Element-2</div>
      <div class = "inner" id = "destination">Element-3</div>
      <div class = "wrapper" style = "background-color:blue;">ONE</div>
      <div class = "wrapper" style = "background-color:green;">TWO</div>
      <div class = "wrapper" style = "background-color:red;">THREE</div>

This will produce following result −