Метод .wrapAll() используется для помещения набора элементов внутрь нового дескриптора. Вместо создания индивидуальных оболочек на основе нового дескриптора вокруг каждого элемента текущего выбранного набора, он группирует все выбранные элементы и создает одну оболочку вокруг всей группы.

Чтобы заключить все абзацы на странице в элемент div с желтым фоном, используйте приведенный ниже код.

var div = $("<div>", {
      "css":{"background-color":"yellow"}
   });
$("p").wrapAll(div);

После выполнения этого кода на странице появится новый элемент div, и все абзацы отобразятся внутри него на желтом фоне (рис. 2.12).

 Рис. 2.12.  Желтым фоном отмечены границы контейнера div, в который были успешно помещены все абзацы

Относительно метода .wrapAll() следует сделать одно важное замечание: группируя элементы, он перемещает их в DOM. Чтобы убедиться в этом, исйользуйте метод .wrapAll() для заключения каждого абзаца документа в дескрипторы strong.

$("span").wrapAll("<strong />");

Обратите внимание на то, что после выполнения этой команды второй элемент span в документе был размещен в позицию вслед за первым, чтобы их можно было заключить в один дескриптор (рис. 2.13).

Рис. 2.13. Чтобы элементы span можно было заключить в один дескриптор, они размещаются один за другим