Метод .add() добавляет элементы в набор jQuery.

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

Категории: Traversing › Miscellaneous Traversing

.add()

Добавляет элемент(ы) в набор jQuery.

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

Добавлено в jQuery 1.0.add( expression )
Добавлено в jQuery 1.4.add( selector [, context ])
Метод .add() находит элементы, заданные с помощью входного параметра, или создает их на лету. А затем добавляет найденные (или созданные) элементы к исходному набору jQuery и возвращает модифицированный (объединенный) набор jQuery.

Возвращаемое значение: (объект) Набор jQuery.

Параметры:

expression – (строка | элемент | массив | объект jQuery) Строка - селектор jQuery (для добавления соответствующих элементов в набор jQuery), строка с кодом разметки HTML (для добавления созданного на лету элемента в набор jQuery), ссылка или массив ссылок на элементы DOM (для добавления их в набор jQuery), либо набор jQuery (для добавления соответствующих элементов в возвращаемый набор jQuery).
selector – (строка) Строка - селектор jQuery (выражение для отбора элементов на основе их атрибутов или местоположения в дереве DOM для последующего добавления их к исходному набору jQuery).
context – (элемент DOM | объект jQuery | документ HTML) Необязательный параметр - контекст поиска. DOM-элемент или объект jQuery, в которых происходит поиск и отбор элементов, соответствующих заданному селектору selector, для последующего добавления их к исходному набору jQuery. Если параметр context опущен, то в качестве контекста для поиска по умолчанию рассматривается текущий HTML документ.

Примечание:

С помощью метода .add() можно объединять селекторы по условию ИЛИ. Например, $('div').add('p') идентично $('div, p').
Примечание:

При использовании метода .add() в jQuery 1.4 с двумя параметрами (когда вторым аргументом передается context), необходимо помнить, что в данном случае первый аргумент должен быть только селектором jQuery.

Примеры:

// Сначала установим желтый цвет фона для всех элементов 
// <div> в документе, а затем установим красную границу 
// вокруг всех элементов <div> и <p>.

$('div').css('background', 'yellow').add('p').css('border', 
'2px solid red');

// Сначала  создаем набор jQuery всех элементов <div> 
// на странице, затем создаем новый элемент <p>, добавляем
// его в набор  jQuery (но не в DOM-дерево!), а потом добавляем 
// ко всем элементам набора сласс с именем  blue.

$('div').add('<p>Новый абзац</p>').addClass('blue');

[ наверх ]

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

.add()

Добавляет элемент(ы) в набор jQuery.

Добавлено в jQuery 1.0.add( expression )

Добавлено в jQuery 1.4.add( selector [, context ])