jQuery метод .clone()

Определение и применение

jQuery метод .clone() создает копию выбранных элементов, включая дочерние узлы, текст и атрибуты.

jQuery синтаксис:

Синтаксис 1.0:

JavaScript
$( selector ).clone( withDataAndEvents )

withDataAndEvents - Boolean

Синтаксис 1.5:

JavaScript
$( selector ).clone( withDataAndEvents, deepWithDataAndEvents )

withDataAndEvents - Boolean

deepWithDataAndEvents - Boolean

Добавлен в версии jQuery

1.0 (синтаксис расширен в версии 1.5)

Значения параметров

Параметр Описание
withDataAndEvents Логическое значение, указывающее, следует ли копировать обработчики событий вместе с элементами. Начиная с версии jQuery 1.4, данные элементов также будут скопированы. Значение по умолчанию false.
deepWithDataAndEvents Логическое значение, указывающее, следует ли копировать обработчики событий и данные для всех дочерних элементов клонированного элемента. По умолчанию его значение соответствует значению первого аргумента (false).

Пример использования

Использование jQuery метода .clone()

Нажмите ▶, затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.

index.html
HTML
<button>Клик</button><br /><br />
<form>
  <label>Мужчина <input type="radio" name="sex" value="male" /></label>
  <label>Женщина <input type="radio" name="sex" value="female" /></label> <br />
  <label>Больше 18 <input type="checkbox" name="type1" value="low" /></label>
  <label>Меньше 18 <input type="checkbox" name="type2" value="2old" /></label><br />
</form>
main.js
JavaScript
$(document).ready(function () {
    $('button').click(function () {
        $('form:first').clone().appendTo('body')
    })
})

В этом примере с использованием jQuery метода .clone() мы при нажатии на элемент <button> (кнопка) создаем копию первого элемента <form> в документе и с использованием jQuery метода .appendTo() вставляем содержимое в конец целевого элемента <body> (как последний дочерний элемент).

Обратите внимание, что при клонировании элементов <input> с типом радио кнопка (type = "radio") и флаговая кнопка (type = "checkbox") пользовательские данные сохраняются в клонированных элементах.

В следующем примере мы рассмотрим как с использованием метода .clone() клонировать элементы с их событиями.

Пример копирования обработчиков событий вместе с элементами

Нажмите ▶, затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.

index.html
HTML
<button>With Events</button><button>Without Events</button><br /><br />
<form>
  <label>Мужчина <input type="radio" name="sex" value="male" /></label>
  <label>Женщина <input type="radio" name="sex" value="female" /></label> <br />
  <label>Больше 18 <input type="checkbox" name="type1" value="low" /></label>
  <label>Меньше 18 <input type="checkbox" name="type2" value="2old" /></label><br />
</form>
main.js
JavaScript
$(document).ready(function () {
    $('button:first').click(function () {
        $('form:first').clone(true).appendTo('body')
    })
    $('button:last').click(function () {
        $('form:first').clone().appendTo('body')
    })
    $('input').click(function () {
        console.log('Клик')
    })
})

В этом примере с использованием jQuery метода .clone() мы при нажатии на первый элемент <button> (кнопка) создаем копию первого элемента <form> в документе вместе с обработчиками событий и с использованием jQuery метода .appendTo() вставляем содержимое в конец целевого элемента <body> (как последний дочерний элемент).

Обратите внимание, что при клонировании элементов с использованием второй кнопки при клике на элементы <input> не будет выводиться информация о клике в консоль, по той причине, что элементы формы были скопированы без обработчиков событий.