Справочник API
.each() в jQuery
Содержание статьи
-
Категории: Miscellaneous › Collection Manipulation , Traversing › Miscellaneous Traversing
Производит обход (перебор в цикле) всех элементов набора jQuery и вызывает функцию обратного вызова для каждого из них.
Синтаксис и описание:
Добавлено в jQuery 1.0.each( callback( [index, Element] ) )
Метод .each() производит обход всех элементов, содержащихся в наборе jQuery и вызывает функцию обратного вызова callback для каждого из них. Не путать с функцией jQuery.each().
Возвращаемое значение: (объект) Набор jQuery.
Параметры:
callback( [index, Element] ) – (функция) Функция, вызываемая для каждого элемента в наборе jQuery. С каждой итерацией в качестве первого параметра index ей передается индекс текущего элемента в наборе Query (начиная с 0) как индекс текущей итерации цикла. Во втором аргументе Element передается ссылка на сам DOM элемент. Контекст this вызова функции также каждый раз ссылается на текущий элемент, задействованный в данной итерации (
Element == this).
-
Примечание:
Цикл можно остановить в любой момент, вернув из функции обратного вызова false.
Примеры:
Перебор элементов и выход из цикла .each
// Выводить в цикле содержимое пунктов списка до тех пор, // пока не попадется <li> с классом 'stop'. $('li').each(function(i,elem) { if ($(this).hasClass("stop")) { alert("Остановлено на " + i + "-м пункте списка."); return false; } else { alert(i + ': ' + $(elem).text()); } });