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

Дата добавления: 2015-07-09; просмотров: 658; Нарушение авторских прав

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

· Добавлено в 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 документ.

1. Примечание:

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

2. Примечание:

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

Примеры:

1.

2. // Сначала установим желтый цвет фона для всех элементов 3. // <div> в документе, а затем установим красную границу 4. // вокруг всех элементов <div> и <p>.5. 6. $('div').css('background', 'yellow').add('p').css('border', '2px solid red');
7.
8. // Сначала создаем набор jQuery всех элементов <div> 9. // на странице, затем создаем новый элемент <p>, добавляем10.// его в набор jQuery (но не в DOM-дерево!), а потом добавляем 11.// ко всем элементам набора сласс с именем blue.12. $('div').add('<p>Новый абзац</p>').addClass('blue');
· .andSelf()

<== предыдущая лекция | следующая лекция ==>

Создает копии элементов набора jQuery. (Клонирует элементы.) | Отменяет текущий и возвращает предыдущий набор jQuery в пределах цепочки команд.