Справочник API
.clone() в jQuery
Содержание статьи
-
Категории: Manipulation › Copying
Создает копии элементов набора 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>Демонстрация примера:
Привет Привет, как дела ?