wrap()

Метод wrap() вставляет каждый элемент выборки в указанный элемент (оборачивает указанным элементом).

Варианты использования

jQ_object.wrap(HTML-код) => jQuery
Вставляет каждый элемент выборки в указанный HTML-код.
jQ_object.wrap(DOM-элемент) => jQuery
Вставляет каждый элемент выборки в указанный DOM-элемент.
jQ_object.wrap(jQuery-объект) => jQuery
Вставляет каждый элемент выборки в элемент, представленный jQuery-объектом.
jQ_object.wrap(функция) => jQuery
Вставляет каждый элемент выборки в HTML-код, возвращаемый указанной функцией. Данная функция выполняется для каждого элемента выборки отдельно.
При запуске функции первым аргументом передаётся индекс элемента в выборке. Ссылка на сам элемент хранится в переменной this.

Примеры

<html>
<head>
  <title>Работа с элементами DOM</title>
  <script type="text/javascript" src="js/jquery.js"></script>
  <style>
    .elem1 {background: red;}
    .elem2 {background: blue;}
  </style>
</head>
<body>
  <p>Параграф 1</p>
  <p>Параграф 2</p>
</body>
</html>
 
<script>
$('p')
/* выбор всех параграфов */
  .wrap(function (index) {
    return '<div class="elem' + (index + 1) + '"></div>';
  });
/* 'обёртывание' каждого параграфа */
</script>

Параграф 1

Параграф 2