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

 

Сегодня: 06 декабря 2016 года, Вторник
Раздел API на стадии наполнения...

 

 

 

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

  • Добавлено в 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.  

    // Сначала установим желтый цвет фона для всех элементов 
    // <div> в документе, а затем установим красную границу 
    // вокруг всех элементов <div> и <p>.
    
    $('div').css('background', 'yellow').add('p').css('border', 
    '2px solid red');
  2.  

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

[ наверх ]










 




Справочник по jQuery JavaScript API на русском языке