Метод .clone() создает копии элементов набора jQuery. (Клонирует элементы.)

Главная » jQuery API » .clone()

Категории: Manipulation › Copying

.clone()

Создает копии элементов набора jQuery. (Клонирует элементы.)

Синтаксис и описание:

Добавлено в jQuery 1.0.clone( [withDataAndEvents] )
Функция .clone() cоздает копии элементов набора jQuery и возвращает набор jQuery, состоящий из этих копий. От значения входного параметра withDataAndEvents зависит, будут ли вместе с элементами копироваться установленные в них обработчики событий (а в версии jQuery 1.4 еще и данные, хранимые на элементе).

Возвращаемое значение: (объект) Набор jQuery - вновь созданный набор, состоящий из копий элементов.

Параметры:

withDataAndEvents – (boolean - логическое значение) Необязательный параметр. Если задан и имеет значение true, то месте с элементами копируются их обработчики событий, а в версии jQuery 1.4 еще и хранимые при элементе данные, прикрепленные с помощью метода .data(). Если опущен или имеет значение false, то обработчики событий (и данные) не копируются

Примечание:

Элементы копируются вместе со всеми дочерними узлами.
Примечание:

Функция возвращает новый набор jQuery, не изменяя первоначальный набор.
Примечание:

Элементы, полученные в результате клонирования, и их содержимое можно модифицировать средствами jQuery даже до того, как они будут вставлены в DOM дерево.

Примеры:

// Сделать копию элемента <b> и вставить его 
// в параграф <p> перед всем его содержимым.

<b>Привет</b><p>, как дела ?</p>
<script>$("b").clone().prependTo("p");</script>

// Результат :
// <b>Привет</b><p><b>Привет</b>, как дела ?</p>

Демонстрация примера:

Привет
Привет, как дела ?

[ наверх ]

www.jQueryBook.ru - jQuery документация

.clone()

Создает копии элементов набора jQuery. (Клонирует элементы.)

Добавлено в jQuery 1.0.clone( [withDataAndEvents] )