jQuery метод .clone()
Определение и применение
jQuery метод .clone() создает копию выбранных элементов, включая дочерние узлы, текст и атрибуты.
jQuery синтаксис:
Синтаксис 1.0:
$( selector ).clone( withDataAndEvents )withDataAndEvents - Boolean
Синтаксис 1.5:
$( 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
<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
$(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
<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
$(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>
не будет выводиться информация о клике в консоль, по той причине, что элементы формы были скопированы без обработчиков
событий.